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2.18.1  CAS  Console  Definitions 


2.18.1.1  CAS.h 

Development:SIMNET:MCC:CAS:CAS.h 

CAS.h  defines  the  representation  of  information  communicated  between  the  CAS 
Macintosh  application  and  the  MCC  host. 


2.18.1.2  CASMac.h 

Development:  SIMNET :  MCC:  CAS  :CAS  Mac.h 

CASMac.h  defines  types,  constants  and  routines  used  within  the  CAS  Macintosh 
application.  Table  2.18-1  describes  the  variables  used  by  CASMac.h. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

scheduleDialog 

extern  pointer  to  OialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

scheduleField 

extern  ScrollTableFieldDefn 

Devetopment;SIMNET  :libmac; 
scroll. h 

onStationDialogDefn 

extern  DialogDefn 

DevelopmentiSIMNET  :libmac; 
dialog. h 

bingoFuelDialogDefn 

extern  DialogDefn 

Development:SIMNET  :libmac: 
dialog. h 

undoField 

extern  PushButtonFieldDefn 

Development:SIMNET  :libmac: 
dialog. h 

cancelField 

extern  PushButtonFieldDefn 

Development.SIMNET.libmac. 
dialog. h 

Table  2.18-1  CASMac.h  Variable  Information. 

2.18.1.3  version. h 

Development:SIMNET:MCC:CAS:version.h 

version. h  defines  constants  that  determine  which  version  of  the  CAS  application  is 
compiled. 
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2.18.1.4  data.c 

Development:  S IMNET :  MCC:  CAS  :data.c 

data.c  defines  various  data  structures  used  by  the  CAS  application  such  as  tables  of 
information  about  CAS  missions.  Table  2.18-2  describes  the  variables  used  by  data.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

application 

pointer  to  char 

Standard  C  type. 

authors 

pointer  to  char 

Standard  C  type. 

pointer  to  char 

Standard  C  type. 

undoField 

extern  PushButtonFieldDefn 

Development:SIMNET  :libmac: 
dialog. h 

cancelField 

extern  PushButtonFieldDefn 

Development:SIMNET  :libmac: 
dialog. h 

descriptionStrinqs 

pointer  to  char 

Standard  C  type. 

Table  2.18-2  data.c  Variable  Information. 

2.18.1.5  resource.h 

Development:SIMNET:MCC:CAS:resource.h 

resource.h  defines  the  numbers  of  the  resources  present  in  the  CAS  Pictures  resource  file. 


2.18.1.6  ditl.h 

Development:SIMNET:MCC:CAS  :ditl.h 

ditl.h  defines  the  numbers  of  items  within  CAS  application  dialogs. 


2.18.2  CAS  Console  Software 


2.18.2.1  condition. c 

Development:SlMNET:MCC:CAS:condition.c 

condition.c  implements  dialogs  reporting  the  situations  of  aircraft  arriving  on  station  and 
aircraft  reaching  the  bingo  fuel  condition.  Table  2.18-3  describes  the  variables  used  by 
condition.c. 
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1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

conditionOialog 

pointer  to  DialogState 

Development:SIMNET  ilibmac: 
dialoQ.h 

currentCondition 

MissionHandle 

Development:SIMNET  :MCC: 
CAS:CASMac.h 

conditionTime 

unsiqned  Iona 

Standard  C  type. 

conditionBuffe: 

MissionDescriptor 

Development:SIMNET  :MCC: 
CASiCASMac.h 

conditionCallSignField 

TextFieldDefn 

DevelopmentiSIMNET  ilibmac; 
dialog.h 

conditionLocationField 

CoordinatesFieldDefn 

DevelopmentiSIMNET  ilibmac; 
dialoq.h 

conditionHeading  Field 

NumberFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoQ.h 

conditionFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoQ.h 

bingoFuelDialogDefn 

Dialog  Defn 

DevelopmentiSIMNET  ilibmaci 
dialOQ.h 

onStationDialogDefn 

Dialog  Oefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

Table  2.18-3  condition.c  Variable  Information. 
2.18.2.1.1  SetUpCondition 


SetUpCondition  initializes  the  condition  dialogs.  The  function  call  is  SetUpCondition(). 
Table  2. 18-4  describes  the  functions  called  using  this  function. 


1  Calls  I 

Function 

Where  Described 

NewRr 

Standard  Memory  Manaqer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

Setup 

See  2.18.2.8.1. 

Table  2.18-4  SetUpCondition  Information. 

2.18.2.1.2  CheckForCondition 

CheckForCondition  checks  for  an  aircraft  arriving  on  station  or  reaching  its  bingo  fuel 
condition.  The  function  call  is  CheckForConditionQ.  Table  2.18-5  describes  the  internal 
variables  used  and  functions  called  using  this  function. 


I  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

now 

unsigned  long 

Standard  C  type. 

time 

unsigned  long 

Standard  C  type. 

m 

register  MissionHandle 

DevelopmentiSIMNET  iMCCi 
CASiCASMac.h 

I  I 
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1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

UpdateMission 

See  Section  2.18.2.6.2. 

CancelMission 

See  Section  2.18.2.6.4. 

ThrowDialoa 

See  Section  2.22.1.11.3. 

ClearDialoQsForMission 

See  Section  2.18.2.2.3. 

RaiseCondition 

See  Section  2.18.2.1.3. 

Called  By 

Function 

Where  Described 

MainEventLoop 

See  Section  2.18.2.5.2. 

Table  2.18-5  CheckForCondition  Information. 
2.18.2.1.3  RaiseCondition 

RaiseCondition  interrupts  the  user  with  a  notice  of  an  aircraft  on  station  or  a  bingo  fuel 
condition.  The  function  call  is  RaiseCondition(m,  dialog).  Table  2.18-6  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters  | 

Parameter 

Where  Typedef  Declared 

m 

MissionHandle 

Development:SIMNET  :MCC: 
CASiCASMac.h 

dialog 

pointer  to  DialogDefn 

Deyelopment:SIMNET  ilibmac: 
dialog. h 

Calls  i 

Function 

Where  Described 

ClearDialodsForMission 

See  Section  2.18.2.2.3. 

ShowDialoq 

See  Section  2.22.1.11.1. 

Show  Window 

Standard  Window  Manager  function  for  Macintosh. 

SysBeep 

Standard  Operating  System  Utility  function  for  Macintosh. 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

Called  By  I 

Function 

Where  Described 

CheckForCondition 

See  Section  2.18.2.1.2. 

MainEventLoop 

See  Section  2.18.2.5.2. 

Table  2.18-6  RaiseCondition  Information. 
2.18.2.1.4  ConditionFetch 


ConditionFetch  reads  the  current  values  of  the  station  and  bingo  fuel  condition  data 
structures  into  the  Condition  dialogs.  The  function  call  is  ConditiotiFetch(dialog). 
2.18-7  describes  the  parameters  used  and  functions  called  using  this  function. 


!  able 
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1  Parameters  | 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentrSIMNET  :libmac: 
dialog,  h 

- 

Internal  Variables 

Variable 

Where  Tvoedef  Declared 

theltem 

Handle 

Development:THINK  C: 

Mac  #includes:MacTvpes.h 

i 

int 

Standard  C  type. 

box 

Rect 

Development;THINK  C: 

Mac  #includes;MacTypes.h 

1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialoo  Manager  function  for  Macintosh. 

HideControl 

Standard  Control  Manager  function  for  Macintosh. 

StuffHeldMission 

See  Section  2.18.2.2.9. 

Table  2.18-7  ConditionFetch  Information. 
2.18.2.1.5  ConditionEvent 


ConditionEvent  handles  events  in  the  Condition  dialog.  The  function  call  is 
ConditionEvent(dialog,  itemNo).  Table  2.18-8  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development.SIMNET  :libmac; 
dialog. h 

itemNo 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

showhelp 

See  Section  2.22.1.19.4. 

UpdateDialog 

See  Section  2.22.1.11.2. 

CancelMission 

See  Section  2.18.2.6.4. 

Throw  Dialog 

See  Section  2.22.1.11.3. 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

UpdateMission 

See  Section  2.18.2.6.2. 

ClearHot 

See  Section  2.18.2.6.5. 

HiliteMission 

See  Section  2.18.2.6.3. 

Table  2.18-8  ConditionEvent  Information. 

2.18.2.2  dialog. c 

Development:  S  IMNET:MCC:  CAS  rdialog.c 

dialog.c  implements  dialogs  for  creating  and  viewing  the  status  of  CAS  missions.  Table 
2.18-9  describes  the  variables  used  by  dialog.c. 
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Variables 

Variable 

Type 

Where  Typedef  Declared 

preplannedDialogDefn 

extern  DialogDefn 

Oevelopment:SIMNET  :libmac; 
dialog. h 

onCallDialogOefn 

extern  DialogDefn 

DevelopmentiSIMNET  ;libmac; 
dialog. h 

heldDialgoDefn 

extern  DialogDefn 

Development:SIMNET  :libmac: 
dialog. h 

pastDialogDefn 

extern  DialogDefn 

Development;SIMNET  ;libmac; 
dialog. h 

missionDialog 

pointer  to  DialogState 

Development;SIMNET  :libmac; 
dialog. h 

currentMission 

MissionHandle 

DevelopmentrSIMNET  ;MCC; 
CASiCASMac.h 

missionBuffer 

MissionDescriptor 

Development:SIMNET  :MCC: 
CAS:CASMac.h 

futureTOTFiekj 

DTGFieldDefn 

Development:SIMNET  :libmac: 
dialog. h 

futureCallSignField 

TextFieldDefn 

Development:SIMNET  ;libmac; 
dialog. h 

futureLocationField 

Coordi  natesFieldDef  n 

DevetopmentiSIMNET  :libmac: 
dialog. h 

lutureHeadingField 

NumberFieldDefn 

Development;SIMNET  ;libmac: 
dialog. h 

futureTargetFiekJs 

RBFiekjDefn 

Development:SlMNET  ;libmac; 
dialog,  h 

fulureSortiesFiekJ 

NumberFieldDefn 

DevelopmentiSIMNET  :libmac: 
dialog. h 

lutureFieldList 

pointer  to  array  of  FieldDeIn 

Development;SIMNET;libmac. 
dialog. h 

preplannedDialogDefn 

DialogDefn 

Development  :SIMNET  ilibmac: 
dialog. h 

onCallDialogDefn 

DialogDefn 

Devetopment:SIMNET  ilibmac: 
dialog. h 

heldCallSignField 

TextFieldDefn 

Development.SIMNETilibmac: 
dialog. h 

heldLocationField 

CoordinatesFieldDefn 

Development:.SlMNET  :libmac 
dialog. h 

heldHeadingField 

NumberFieldDefn 

DevelopmentiSIMNET  rlibmac: 
dialog  h 

heldFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentSiMNET  ilibmac: 
dialog. h 

heldDialogDefn 

DialogDefn 

Development:SIMNET  :libmac: 
dialog. h 

past  ResultsField 

TextFieldDefn 

Development:SIMNET  ilibmac; 
dialog. h 

pastFieldLisi 

pointer  to  array  of  FieldDefn 

Development  SIMNET :libmac; 
dialog. h 

pastDialogDefn 

DialogDefn 

DevelopmentiSIMNET  :libmac: 
dialog  h 

Table  2.18-9  dialog.c  Variable  InformaliDn. 


592 


BBN  Systems  and  Technologies 


MCC  CSCl 


2.18.2.2.1  SetUpDialog 

SetUpDialog  initializes  the  mission  dialog  data  structures.  The  function  call  is 
SetUpDialogO.  Table  2.18-10  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

NewRr 

Standard  Memory  Manaoer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

Setup 

See  Section  2.18.2.8.1. 

Table  2.18*10  SetUpDialog  Information. 

2.18.2.2.2  ShowM ission 

ShowMission  puts  up  a  dialog  box,  box,  for  a  mission,  m,  according  to  the  status  of  the 
mission.  The  function  call  is  ShowMission(m,  box).  Table  2.18-1 1  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

m 

MissionHandle 

Development;SIMNET  ;MCC: 
CAS:CASMac.h 

box 

pointer  to  Rect 

DevelopmentTHINK  C: 

Mac  #includes;MacTvpes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogDefn 

DevelopmentiSIMNET  :libmac: 
dialog. h 

Calls 

Function 

Where  Described 

ShowDialoq 

See  Section  2.22.1.11.1. 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

ShowV.'indow 

Standard  Window  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

ScheduleSelect 

See  Section  2.18.2.7.3. 

ScheduleEvent 

See  Section  2.18.2.7.12. 

Table  2.18*11  ShowMission  Information. 

2.18.2.2.3  ClearDialogsForMission 

ClearDialogsForMission  throws  away  the  frontmost  dialogs  for  help,  and  alerts  any  dialogs 
related  to  the  indicated  mission,  m.  The  function  call  is  ClearDialogsForMission(m). 

Table  2.18-12  describes  the  parameters  used  and  functions  called  using  this  function. 


593 


BBN  Systems  and  Techno  1.' .ies 


MCC  CSCI 


Parameters 

Parameter 

Type 

Where  Tvpedef  Declared 

m 

MissionHandle 

Development'.SIMNET  ;MCC: 
CAS:CASMac.h 

Variable 


w 


newFront 


Internal  Variables 


e 


WindowRr 


WindowPtr 


Where  Tvoedef  Declared 


DevelopmentiTHINK  C: 

Mac  #includes:WindowMqr.h 


DevelopmentTHINK  C: 

Mac  #includes;WindowMQr.h 


Function 


ThrowDialo 


FrontWindow 


DisDOsDialo 


Calls 


Where  Described 


See  Section  2.22.1.11.3. 


Standard  Window  Manaoer  function  for  Macintosh. 


Standard  Dialoo  Manaoer  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

RaiseCondition 

See  Section  2.18.2.1.3. 

CheckForCondition 

See  Section  2.18.2.1.2. 

Table  2.18<12  CiearDialogsForMission  Information. 

2.18.2.2.4  StuffTimeOnTarget 

StuffTimeOnTarget  fills  time  on  target  data  into  the  specified  dialog  item.  The  function  call 
is  StuffTimeOnTarget  (dialog,  itemNo,  m).  Table  2.18-13  describes  the  parameters  used 
and  functions  called  using  this  function. 
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1  Called  By  I 

Function 

Where  Described 

OnCallFetch 

See  Section  2.18.2.2.6. 

StuffHeldMission 

See  Section  2.18.2.2.9. 

PastFetch 

See  Section  2.18.2.2.12. 

Table  2.18-13  StuffTimeOnTarget  Information. 

2.18.2.2.5  ZoomMissionDown 

ZoomMissionDown  zooms  between  an  entry  in  the  Scheduled  Missions  Table  and  its  pop¬ 
up  Mission  dialog.  The  function  call  is  ZoomMissionDown  ().  Table  2.18-14  describes 
the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

row 

int 

Standard  C  type. 

box 

Rect 

DevelopmentTHINK  C; 

Mac  #includes:MacTypes.h 

Calls 

Function 

Where  Described 

ScrollTableEntryToRow 

See  Section  2.22.1.34.1. 

ScrollTableRowRect 

See  Section  2.22.1.34.3. 

HideWindow 

Standard  Window  Manaaer  function  for  Macintosh. 

ZoomToWindow 

See  Section  2.22.1.47.4. 

Called  By 

Function 

Where  Described 

FutureEvent 

See  Section  2.18.2.2.7. 

Table  2.18-14  ZoomMissionDown  Information. 

2.18.2.2.6  OnCallFetch 

OnCallFetch  reads  current  mission  data  into  the  On  Call  Mission  dialog.  The  function  call  is 
OnCallFetch(dialog).  Table  2.18-15  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

Deyelopment:SIMNET  :libmac; 
dialog. h 

1  Calls  1 

Function 

Where  Described 

StuffTimeOnTarget 

See  Section  2.18.2.2.4. 

Table  2.18-15  OnCallFetch  Information. 
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itemNo 


Standard  C  type. 


Function 


showhel 


UpdateDialo 


CancelMission 


Throw  Dialo 


CheckMandatorvFields 


CheckSortieLimits 


UpdateMission 


HiliteMission 


ZoomMissionDown 


Calls 


Where  Described 


See  Section  2.22.1.19.4. 


See  Section  2.22.1.11.2. 


See  Section  2.18.2.6.4. 


See  Section  2.22.1.11.3. 


See  Section  2.22.1.13.1. 


See  Section  2.18.2.3.4. 


See  Section  2.18.2.6.2. 


See  Section  2.18.2.6.3. 


See  Section  2.18.2.2.5. 


Table  2.18-16  FutureEvent  Information. 

2.18.2.2.8  ValidTOT 

ValidTOT  determines  if  the  time  on  target  is  valid.  The  time  on  target  must  be  at  least  25 
minutes  from  now  and  on  the  same  day,  or  it  is  not  valid.  The  function  call  is 
ValidTOT(dialog,  fp,  str).  Table  2.18-17  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  ilibmac: 
dialog. h 

Ip 

pointer  to  TypeInFieldDefn 

Development:SIMNET  ilibmac; 
dialog. h 

Variable 


now 


today 


inter  to  char 


Standard  C  type. 


Internal  Variables 


e 


unsigned  Ion 


DateTimeRec 


Where  Tvoedef  Declared 


Standard  C  type. 


DeyelopmentiTHINK  C 
Mac  #includes:OSUtii  h 


Return  Value 


0 


1 


Return  Values 


Type 


int 


int 


Meaning 


Time  not  valid. 


Time  valid. 
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1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operatina  System  Utility  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

GetTime 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

Macro  defined  in  Oevelopment;SIMNET:MCC:CAS;CASMac.h. 

Table  2.18-17  ValidTOT  Information. 
2.18.2.2.9  StuffHeldMission 


StuffHeldMission  fills  in  the  fields  of  a  dialog,  dialog,  for  a  mission,  m,  with  a  “held” 
status.  The  function  call  is  StuffHeldMission(dialog,  m).  Table  2.18-18  describes  the 
parameters  used  and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  ilibmac; 
dialog. h 

m 

MissionHandle 

Development:SIMNET:MCC; 
CAS:CASMac  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

descriptionStrinqs 

extern  pointer  to  array  of  char 

Standard  C  type. 

str 

array  of  10  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

SelText 

See  Section  2.22.1.11.8. 

StuffTimeOnTarqet 

See  Section  2.18.2.2.4. 

Called  By 

Function 

Where  Described 

HeldFetch 

See  Section  2.18.2.2.10. 

ConditionFetch 

See  Section  2.18.2.1.4. 

Table  2.18-18  StuffHeldMission  Information. 

2.18.2.2.10  HeldFetch 

HeldFetch  reads  the  current  values  of  the  "held"  missions  into  the  Held  Missions  dialog. 
The  function  call  is  HeldFetch(dialog).  Table  2.18-19  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  rlibmac; 
dialog. h 

1  1 
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1  Calls  1 

Function 

Where  Described 

StutfHeldMission 

See  Section  2.18.2.2.9. 

Table  2.18-19  HeldFetch  Information. 


2.18.2.2.11  HeldEvent 


HeldEvent  handles  events  in  the  Held  Missions  dialog.  The  function  call  is 
HeldEvent(dialog,  itemNo).  Table  2. 18-20  describes  the  parameters  used  and  functions 
called  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentrSIMNET  ;libmac; 
dialog,  h 

itemNo 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

showhelp 

See  Section  2.22.1.19.4. 

UpdateDialoo 

See  Section  2.22.1.11.2. 

CancelMission 

See  Section  2.18.2.6.4. 

ThrowDialoa 

See  Section  2.22.1.11.3. 

CheckMandatorvFields 

See  Section  2.22.1.13.1. 

UpdateMission 

See  Section  2.18.2.6.2. 

ClearHot 

See  Section  2.18.2.6.5. 

Table  2.18-20  HeldEvent  Information. 


2.18.2.2.12  PastFetch 


PastFetch  reads  the  values  of  past  missions  into  the  Past  Missions  dialog.  The  function  call 
is  PastFetch(dialog).  Table  2.18-21  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameters  | 

Parameter 

Type 

Where  Typedel  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

descriptionStrinqs 

extern  pointer  to  array  of  char 

Standard  C  type. 

str 

array  of  10  char 

Standard  C  type 

Calls 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

Stuff  TimeOnTarqet 

See  Section  2.18.2.2.4. 

Table  2.18-21  PastFetch  Information. 
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2.18.2.2.13  PastEvent 

PastEvent  handles  events  in  the  Past  Missions  dialog.  The  function  call  is 
PastEvent(dialog,  itemNo).  Table  2.18-22  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  ilibmac: 
dialoq.h 

itemNo 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

showhelp 

See  Section  2.22.1.19.4. 

UpdateDialoq 

See  Section  2.22.1.11.2. 

UpdateMission 

See  Section  2.18.2.6.2. 

ThrowDialoq 

See  Section  2.22.1.11.3. 

Table  2.18-22  PastEvent  Information. 


2.18.2.3  limits. c 

Development:SIMNET:MCC:CAS:limits.c 

limits.c  contains  routines  that  implement  and  display  the  limits  of  preplanned  and  on-call 
CAS  sorties.  Table  2.18-23  describes  the  variables  used  by  limits.c. 


1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

totalSorties 

int 

Standard  C  type. 

preplannedSorties 

int 

Standard  C  type. 

daySortiesAllotted 

DateTimeRec 

DeyelopmentTHINK  C: 

Mac  #includes:OSUtil.h 

monthNames 

pointer  to  array  of  char 

Standard  C  type. 

Table  2.18-23  limits.c  Variable  Information. 

2.18.2.3.1  SetSortieLimits 

SetSortieLimits  sets  the  total  and  per-day  sortie  limits,  totall  is  the  total  number  of  sorties 
and  preplanned  is  the  number  of  sorties  for  today.  The  function  call  is 
SetSonieLimits(total,  preplanned).  Table  2.18-24  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

total 

int 

Standard  C  type. 

preplanned 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

GetTime 

Standard  Operatinq  System  Utility  function  for  Macintosh. 
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Called  By 

Function 

Where  Described 

LoadCannedLimits 

See  Section  2.18.2.4.2. 

ProcessRequest 

See  Section  2.18.2.5.3. 

Table  2.18-24  SetSortieLimits  Information. 

2.18.2.3.2  AdditionalSorties 

AdditionalSorties  is  called  when  more  sorties  are  added  to  the  number  allotted  for  today. 
extra  is  the  number  of  additional  sorties  guested.  These  sorties  may  only  be  used  for  on- 
call  missions.  The  function  call  is  AdditionalSorties(extra).  Table  2.18-25  describes  the 
parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

extra 

int 

Standard  C  type. 

1  Called  By  I 

Function 

Where  Described 

MainEventLoop 

See  Section  2.18.2.5.2. 

Table  2.18-25  AdditionalSorties  Information. 

2.18.2.3.3  ShowSummary 

ShowSummary  puts  up  a  dialog  box  summarizing  the  sortie  limits  and  number  of  sorties 
used  so  far.  The  function  call  is  ShowSummaiy().  Table  2.18-26  describes  the  internal 
variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

dialog 

register  DialogRr 

Development:THINK  C: 

Mac  #includes;DialOQMqr.h 

i 

int 

Standard  C  type. 

totalSortiesUsed 

int 

Standard  C  type. 

preplannedSortiesUsed 

int 

Standard  C  type. 

totalSortiesRemaininq 

int 

Standard  C  type. 

theltem 

Handle 

DevelopmentTHiNK  C 

Mac  #includes;MacTypes.h 

box 

Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

Str 

array  of  256  char 

Standard  C  type. 

1  1 
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1  Calls  1 

Function 

Where  Described 

ShowSimple  Dialog 

See  Section  2.22.1.40.1. 

SetWTitle 

Standard  Window  Manager  function  for  Macintosh. 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

SetIText 

Standard  Dialog  Manager  function  for  Macintosh. 

SortiesScheduled 

See  Section  2.18.2.3.5. 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

ShowWindow 

Standard  Window  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

ScheduleEvent 

See  Section  2.18.2.7.12. 

Table  2.18-26  ShowSummary  Information. 


2.18.2.3.4  CheckSortieLimits 

CheckSortieLimits  checks  to  see  that  the  sortie  limits  are  not  exceeded.  The  function  call  is 
CheckSortieLimits(currentMission,  b).  Table  2.18-27  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

currentMission 

MissionHandle 

DevelopmentiSIMNET  :MCC: 
CAS:CASMac.h 

register  pointer  to 
MissionDescriptor 


Development.SIMNET.MCC: 

CAS:CASMac.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

m 

register  MissionHandle 

Development:SIMNET  ;MCC: 
CAS:CASMac.h 

totalSortiesUsed 

int 

Standard  C  type. 

replannedSortiesUsed 


str 


int 


array  of  char 


Standard  C  type. 


Standard  C  type. 


Return  Value 


Type 

Meaning 

int 

Sortie  limit  will  be  exceeded. 

int 

Sortie  limit  will  not  be 
exceeded. 

Function 


ShowCaution 


SortiesScheduled 


Calls 


Where  Described 


Macro  defined  in  Develooment:SIMNET:MCC:CAS:CASMac.h. 


See  Section  2.22.1.4.1. 


See  Section  2.18.2.3.5. 
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1  Called  By  I 

Function 

Where  Described 

FutureEvent 

See  Section  2.18.2.2.7. 

Table  2.18-27  CheckSortieLimits  Information. 

2.18.2.3.5  SortiesScheduled 

SortiesScheduled  computes  the  number  of  sorties  scheduled  for  a  given  day,  date.  The 
function  call  is  SortiesScheduled(date,  totalSortiesUsed,  preplann^sortiesUsed).  Table 
2.18-28  describes  the  parameters  used  and  functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

date 

register  pointer  to 

DateTimeRec 

Development:THINK  C: 

Mac  #includes:OSUtil.h 

totalSortiesUsed 

pointer  to  int 

Standard  C  type. 

prepiannedSortiesUsed 

pointer  to  int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

m 

register  MissionHandle 

Development.SIMNET  :MCC; 
CAS:CASMac.h 

I  Calls  I 

I  Function 

Where  Described 

Macro  defined  in  Development:SIMNET:MCC:CAS;CASMac.h. 

I  Called  By  I 

Function 

Where  Described 

CheckSortieLimits 

See  Section  2.18.2.3.4. 

ShowSummary 

See  Section  2.18.2.3.3. 

Table  2.18-28  SortiesScheduled  Information. 

2.18.2.4  load.c 

Development;SIMNET  ;MCC:CAS  :load.c 

load.c  loads  canned  data  into  application  data  structures,  in  the  standalone  demo  version  ot 
the  CAS  application.  The  routines  in  this  file  are  only  compiled  if  VERSION  is 
FULDAGAP.  Table  2.18-29  describes  the  variables  used  by  load.c. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

cannedMissions 

array  of  CannedMission 

Development;SIMNET  ;MCC: 
CASiload.c 

Table  2.18-29  load.c  Variable  Information. 
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2.18.2.4.1  LoadCannedTerrainMap 

LoadCannedTerrainMap  loads  a  canned  terrain  map.  The  function  call  is 
Lx>adCannedTerrainMap().  Table  2.18-30  describes  the  function  calling  this  function. 


1  Called  By  I 

Function 

Where  Described 

main 

See  Section  2.18.2.5.1. 

Table  2.18-30  LoadCannedTerrainMap  Information. 
2.18.2.4.2  LoadCannedLimits 

LoadCannedLimits  loads  canned  sortie  limits.  The  function  call  is  LoadCannedLimits(). 
Table  2.18-31  describes  the  functions  called  using  this  function. 


I  Calls  I 

Function 

Where  Described 

SetSorlieLimits 

See  Section  2.18.2.3.1. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.18.2.5.1. 

Table  2.18-31  LoadCannedLimits  Information. 

2.18.2.4.3  LoadCannedSchedule 

LoadCannedSchedule  populates  the  mission  schedule  with  canned  data.  The  function  call 
is  LoadCannedScheduIe().  Table  2.18-32  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

sortiesRemainina 

extern  array  of  int 

Standard  C  type. 

m 

MissionHandle 

Development:SIMNET  :MCC; 
CAS;CASMac.h 

cm 

pointer  to  CannedMission 

Development:SIMNET  :MCC: 
CAS:load.c 

now 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operatinq  system  Utility  function  for  Macintosh. 

NewMission 

See  Section  2.18.2.6.1. 

HLock 

Standard  Memory  Manaqer  function  for  Macintosh. 

Stri  nqT  oM  apCoordi  nates 

See  Section  2.22.1.26.1. 

DTGEIapsed 

See  Section  2.22.1.15.1. 

HUnlock 

Standard  Memory  Manaqer  function  for  Macintosh. 

UpdateMission 

See  Section  2.18.2.6.2. 
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1  Called  By  I 

Function 

Where  Described 

main 

See  Section  2.18.2.5.1. 

Table  2.18-32  LoadCannedScheduie  Information. 

2.18.2.5  main.c 

Development:SIMNET:MCC:CAS  :main.c 

main.c  contains  the  CAS  application's  program  entry  point  and  main  event  loop. 

2.18.2.5.1  main 

main  is  the  program  entry  point.  The  function  call  is  main().  Table  2.18-33  describes  the 
functions  c^led  using  this  function. 


Calls  I 

Function 

Where  Described 

Setup 

See  Section  2.18.2.8.1. 

Proces&Request 

See  Section  2.18.2.5.3. 

SetUpApplelalk 

See  Section  2.22.1.3.1. 

Download!  e  rrai  nM  ap 

See  Section  2.22.1.3.4. 

MenuBarTitle 

See  Section  2.22.1.43.1. 

InstallClock 

See  Section  2.22.1.6.4. 

ShowSchedule 

See  Section  2.18.2.7.2. 

LooadCannedlerrainMap 

See  Section  2.18.2.4.1. 

LoadCannedLimits 

See  Section  2.18.2.4.2. 

LoadCannedScheduie 

See  Section  2.18.2.4.3. 

MainEventLoop 

See  Section  2.18.2.5.2. 

Table  2.18-33  main  Information. 
2.18.2.5.2  MainEventLoop 


MainEventLoop  constantly  fields  incoming  events.  The  function  call  is  MainEventLoopO. 
Table  2.18-34  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

my  Event 

EventRecord 

Development  lHINK  C: 

Mac  #includes:Ev8ntMqr.li 
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1  Calls  1 

Function 

Where  Described 

CheckForCondition 

See  Section  2.18.2.1.2. 

UpdateClock 

See  Section  2.22.1.6.2. 

SystemTask 

Standard  Desk  Manager  function  for  Macintosh. 

GetNextEvent 

Standard  Toolbox  Event  Manager  function  for  Macintosh. 

AdditionalSorties 

See  Section  2.18.2.3.2. 

RaiseCondition 

See  Section  2.18.2.1.3. 

ATPCIoseSocket 

Standard  Appletalk  Manager  function  for  Macintosh. 

ExitToShell 

Standard  Segment  Loader  function  for  Macintosh. 

ShowrVersions 

See  Section  2.22.1.44.1. 

Window  Event 

See  Section  2.22.1.46.2. 

NetworkEventHandler 

See  Section  2.22.1.3.5. 

Called  Bv 

Function 

Where  Described 

main 

See  Section  2.18.2.5.1. 

Table  2.18-34  MainEventLoop  Information. 


2.18.2.5.3  ProcessRequest 

ProcessRequest  processes  a  request  received  from  the  MCC  host.  This  function  is  only 
compiled  if  VERSION  is  APPLETALK.  The  function  call  is  ProcessRequest(hdl).  Table 
2.18-35  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

hdl 

register  Handle 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

Variable 


errCode 


Internal  Variables 


e 


register  Rr 


Where  Tvoedef  Declared 


Development:THINK  C: 
Mac  #includes;MacTypes.h 


Standard  C  type. 


Calls 

Function 

Where  Described 

SetDateTime 

Standard  Operatino  System  Utility  function  for  Macintosh. 

SetSortieLimits 

See  Section  2.18.2,3.1. 

ATPResponse 


Restart 


ATPError 


letalk  Manaoer  function  for  Macintosh 


Standard  Operatino  System  Utility  function  for  Macintosh. 


See  Section  2.22.1.3.6. 


Function 


main 


Called  B 


Where  Described 


See  Section  2.18.2.5.1. 


Table  2.18-35  ProcessRequest  Information. 
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2.18.2.6  mission. c 

Development:SIMNET:MCC:CAS:mission.c 

mission.c  contains  routines  for  creating  and  updating  data  structures  describing  CAS 
missions. 


2.18.2.6.1  NewMission 

NewMission  allocates  a  record  for  a  new  mission.  The  function  call  is  NewMission(type). 
Table  2.18-36  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


Variable 


Parameters 


Internal  Variables 


\wm 


register  MissionHandle 


unsianed  Ion 


Where  Tvoedef  Declared 


Standard  C  tvoe. 


Where  Tvoedef  Declared 


Development:SIMNET  :MCC: 
CAS:CASMac.h 


Standard  C  tvoe. 


Return  Value 


Return  Values 


Type 


MissionHandle 


Meanin 


Record  for  new  mission. 


Function 


NewHandle 


GetDateTime 


DTG  Elapsed 


Calls 


Where  Described 


Standard  Memory  Manaqer  function  for  Macintosh. 


Standard  Ooeratina  System  Utility  function  for  Macintosh. 


See  Section  2.22.1.15.3. 


Function 


LoadCannedSchedule 


ScheduleEvent 


Called  B 


Where  Described 


See  Section  2.18.2.4.3. 


See  Section  2.18.2.7.12. 


Table  2.18-36  NewMission  Information. 
2.18.2.6.2  UpdateMission 


UpdateMission  updates  a  mission,  m,  in  the  schedule.  The  function  call  is 
UpdateMission(m).  Table  2.18-37  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

m 

MissionHandle 

DevelopmentiSIMNET  ;MCC. 
CASiCASMac.h 

Calls 

Function 

Where  Described 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 
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Called  By 

Function 

Where  Described 

CheckForCondition 

See  Section  2.18.2.1.2. 

ConditionEvent 

See  Section  2.18.2.1.5. 

FutureEvent 

See  Section  2.18.2.2.7. 

Held  Event 

See  Section  2.18.2.2.11. 

PastEvent 

See  Section  2.18.2.2.13. 

LoadCannedSchedule 

See  Section  2.18.2.4.3. 

ClearHot 

See  Section  2.18.2.6.5. 

Table  2.18-37  UpdateMission  Information. 

2.18.2.6.3  HiliteMission 

HiliteMission  hilites  a  mission,  m,  in  the  schedule  table.  The  function  call  is 
HiliteMission(m).  Table  2.18-38  describes  the  parameters  used  and  functions  called  using 
this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

m 

MissionHandle 

DevelopmentiSIMNET  :MCC: 
CAS:CASMac.h 

1  Calls  1 

Function 

Where  Described 

SetScrollTableSe  lection 

See  Section  2.22.1.37.2. 

1  Called  By  1 

Function 

Where  Described 

ConditionEvent 

See  Section  2.18.2.1.5. 

FutureEvent 

See  Section  2.18.2.2.7. 

Table  2.18-38  HiliteMission  Information. 

2.18.2.6.4  CancelMission 

CancelMission  removes  a  mission,  m,  from  the  schedule  and  discards  it.  The  function  call 
is  CancelMission(m).  Table  2.18-39  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

m 

MissionHandle 

Development  ;SIM  NET  :MCC; 
CASiCASMac.h 

Calls 

Function 

Where  Described 

RemoveScrollTableEntry 

See  Section  2.22.1.28.1. 

1  1 
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1  Called  By  I 

Function 

Where  Described 

CheckForCondition 

See  Section  2.18.2.1.2. 

ConditionEvent 

See  Section  2.18.2.1.5. 

FutureEvent 

See  Section  2.18.2.2.7. 

HeldEvent 

See  Section  2.18.2.2.11. 

Table  2.18-39  CancelMission  Information. 

2.18.2.6.5  ClearHot 

ClearHot  is  called  when  a  mission,  m,  is  cleared  hot.  The  function  call  is  ClearHot(m). 
Table  2.18-40  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters 

Parameter 

Where  Typedef  Declared 

m 

MissionHandle 

Development;SIMNET;MCC: 

CAS:CASMac.h 

Internal  Variables 

Variable 

IType _ 1 

Where  Typedef  Declared 

now 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

DTGEIapsed 

See  Section  2.22.1.15.3. 

UpdateMission 

See  Section  2.18.2.6.2. 

NewPtr 

Standard  Memory  Manaqer  function  for  Macintosh 

NewHandle 

Standard  Memory  Manaqer  function  for  Macintosh. 

SetUpATPRequest 

See  Section  2.22.1.3.2. 

ATPError 

See  Section  2.22.1.3.6. 

ATPReqeust 

Standard  Appletalk  Manaqer  function  for  Macintosh. 

1  Called  By  I 

Function 

Where  Described 

ConditionEvent 

See  Section  2.18.2.1.5. 

HeldEvent 

See  Section  2.18.2.2.11. 

Table  2.18-40  ClearHot  Information. 

2.18.2.7  schedule. c 

Development:SIMNET:MCC:CAS:.scheduIe.c 


schedule.c  implements  a  dialog  displaying  a  schedule  of  CAS  missions.  Table  2  18-41 
describes  the  variables  used  by  schedule.c 
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1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

scheduleColumns 

extern  array  of 
ScrollTableColumnDefn 

Development:SIMNET  :libmac: 
scroll,  h 

schedule  Dialog  Defn 

extern  DialogDefn 

DevelopmentiSIMNET  :libmac; 
dialoQ.h 

schedule  Dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac: 
dialog,  h 

scheduleColumns 

array  of 

Scroll!  ableColumnDef  n 

DevelopmentiSIMNET  :libmac: 
scroll,  h 

scheduleField 

ScrollTableFieldDefn 

Development:SIMNET  ;libmac: 
scroll.h 

scheduleFieldList 

pointer  to  FiekfDefn 

Development:SIMNET  ilibmac; 
dialog. h 

scheduleDialogDefn 

DialogDefn 

DevelopmentiSIMNET  ilibmac; 
dialog,  h 

Table  2.18-41  schedule.c  Variable  Information. 


2.18.2.7.1  SetUpSchedule 

SetUpSchedule  initializes  the  mission  schedule.  The  function  call  is  SetUpScleduleO. 
Table  2.18-42  describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

port 

GrafPort 

DevelopmentiTHilsiK  C; 

Mac  #include?. Quickdraw. h 

Calls 

Function 

Where  Described 

NewRr 

Standard  Memory  Manager  function  for  Macintosh, 

OpenPort 

Standard  Quickdraw  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

TextSize 

Standard  Quickdraw  function  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

CharWidth 

Standard  Quickdraw  function  for  Macintosh. 

ClosePort 

Standard  Quickdraw  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

Setup 

See  Section  2.18.2.8.1. 

Table  2.18-42 


SetUpSchedule  Information. 
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2.18.2.7.2  ShowSchedule 

ShowSchedule  brings  up  the  MissionSchedule  dialog.  The  function  call  is 
ShowScheduleO-  Table  2.18-43  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

ShowDialoa 

See  Section  2.22.1.11.1. 

ShowWindow 

Standard  Window  Manaqer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.18.2.5.1. 

Table  2.18-43  ShowSchedule  Information. 

2.18.2.7.3  ScheduleSelect 

ScheduleSelect  checks  the  validity  of  the  seleted  item  and  brings  up  the  next  dialog 
describing  the  selection.  The  function  call  is  ScheduleSelect(defn,  row,  box,  event).  Table 
2.18-44  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFietdDefn 

Development:SIMNET  :libmac: 
scroll. h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvpes.h 

event 

pointer  to  EventRecord 

DevelopmentTHINK  C: 

Mac  #includes:EventMqr.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

entry 

ScrollTableEntryHandle 

DevelopmentiSIMNET  :libmac: 
scroll,  h 

1  Calls  1 

Function 

Where  Described 

ScrollTableRowToEntry 

See  Section  2.22.1.34.1. 

SetScrollT  ableSelection 

See  Section  2.22.1.37.2 

ShowMission 

See  Section  2.18.2.2.2. 

Table  2.18-44  ScheduleSelect  Information. 
2.18.2.7.4  SchedjleHilite 

ScheduleHilitc  highlights  an  entry  in  the  Schedule  Table.  The  function  cttll  is 
ScheduleHilite(defn,  entry,  box).  Table  2.18-45  describes  the  parameters  used  and 
functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

Scroll!  ableFieldDef  n 

Development;SIMNET  :libmac: 
scroll.h 

entry 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

box 

pointer  to  Reel 

Development:THINK  C: 

Mac  #includes;MacTvpes.h 

Calls 

Function 

Where  Described 

InvertRect 

Standard  Ckiickdraw  function  for  Macintosh. 

Table  2.18-45  ScheduleHiiite  Information. 


2.18.2.7.5  ScheduleDrawType 

ScheduleE>rawType  fills  in  the  Type  field  of  the  specified  column  in  the  Schedule  Table. 
The  function  call  is  ScheduleDrawType(defn,  col,  entry).  Table  2.18-46  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

poindter  to 
ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac; 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

Development:SIMNET  rlibmac: 
scroll.h 

entry 

register 

ScrollTableEntryHandle 

Development.SIMNET.libmac; 
scroll  h 

Calls 

Function 

Where  Described 

Move 

Standard  Quickdraw  function  for  Macintosh. 

CharWidth 

Standard  Quickdraw  function  for  Macintosh. 

Drawstring 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.18-46  ScheduIeDrawType  Information. 


2.18.2.7.6  ScheduleDrawTOT 


ScheduleDrawTOT  fills  in  the  TOT  field  of  the  specified  column  in  the  Schedule  Table. 
The  function  call  is  ScheduleDrawTOT(defn,  col,  entry).  Table  2.18-47  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

poindter  to 
ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

entry 

register 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

1  n 
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1  internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

str 

array  of  20  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

DTGToStrina 

See  Section  2.22.1.15.1. 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.18-47  ScheduleDrawTOT  Information. 


2.18.2.7.7  ScheduleDrawLocation 

ScheduleDrawLocation  fills  in  the  Location  field  of  the  specified  column  in  the  Schedule 
Table.  The  function  call  is  ScheduleDrawLocation(defn,  col,  entry).  Table  2.18-48 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


defn 


lEim 


poindter  to 
ScrollTableFieldDefn 


pointer  to 

ScrollTableColumnDefn 


register 

ScrollTableEntryHandle 


Where  Tvoedef  Declared 


Development:SIMNET  ilibmac; 
scroll. h 


DevelopmentiSIMNET  rlibmac; 
scroll. h 


Development:SIMNET  :libmac: 
scroll.h 


Calls 


Function  Where  Described 


DrawText  Standard  Quickdraw  function  for  Macintosh. 


Table  2.18-48  ScheduleDrawLocation  Information. 
2.18.2.7.8  ScheduleDrawDescription 

ScheduleDrawDescription  fills  in  the  Description  field  of  the  specified  column  in  the 
Schedule  Table.  The  function  call  is  ScheduleDrawDescription(defn,  col,  entry).  Table 
2.18-49  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  :libmac: 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

Development:SIMNET  :libmac: 
scroll.h 

entry 

register 

ScrollT  able  EntryHandle 

Developmenf.SIMNET'.libmac; 

scroll.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

descriptionStrings 

extern  pointer  to  array  of  char 

Standard  C  type 

register  pointer  to  char 


Standard  C  tvoe. 
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1  Calls  1 

Function 

Where  Described 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.18-49  ScheduieDrawDescription  Information. 


2.18.2.7.9  ScheduleDrawSorties 

ScheduleDrawSorties  fills  in  the  Sorties  field  of  the  specified  column  in  the  Schedule 
Table.  The  function  call  is  ScheduleDrawSortiesfdefn,  col,  entry).  Table  2.18-50 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

poindter  to 
ScrollTableFieldDefn 

Development:SIMNET  ilibmac; 
scroll,  h 

col 

pointer  to 

ScrollTableColumnDefn 

DevelopmentiSIMNET  ilibmac: 
scroll. h 

entry 

register 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ilibmac; 
scroll. h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  10  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

Move 

Standard  Quickdraw  function  for  Macintosh. 

CharWidth 

Standard  Quickdraw  function  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.18-50  ScheduleDrawSorties  Information. 


2.18.2.7.10  ScheduleDrawResults 


ScheduleDrawResults  fills  in  the  Results  field  of  the  specified  column  in  the  Schedule 
Table.  The  function  call  is  ScheduleDrawResultsfdefn,  col,  entry).  Table  2.18-51 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

poindter  to 
ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

col 

pointer  to 

ScrollT  ableColumnDef  n 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

entry 

register 

ScrollT  abieEntrvHandle 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

~~l 
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1  Calls  1 

Function 

Where  Described 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.18-51  ScheduleDrawResults  Information. 

2.18.2.7.11  ScheduIeDrawStatus 

ScheduIeDrawStatus  fills  in  the  Status  field  of  the  specified  column  in  the  Schedule  Table. 
The  function  call  is  ScheduleDrawStatusfdefn,  col,  entry).  Table  2.18-52  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

poindter  to 
ScrollTableFieldDefn 

Development;SIMNET  ilibmac: 
scroll,  h 

col 

pointer  to 

ScrollTableColumnDefn 

DevelopmentiSIMNET  ;libmac: 
scroll.h 

entry 

register 

ScrollTableEntryHandle 

Development;SIMNET  ilibmac: 
scroll.h 

Calls 

Function 

Where  Described 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh 

TextFace 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.18-52  ScheduIeDrawStatus  Information. 
2.18.2.7.12  ScheduleEvent 

ScheduleEvent  handles  events  for  the  Schedule  dialog.  The  function  call  is 
ScheduleEvent(dialog,  itemNo).  Table  2.18-53  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac: 
dialoo.h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

m 

MissionHandle 

DevelopmentiSIMNET  iMCC: 
CASiCASMac.h 

theltem 

Handle 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

i 

int 

Standard  C  type. 

box 

Reel 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.ti 
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1  Calls  1 

Function 

Where  Described 

showhelp 

See  Section  2.22.1.19.4. 

ShowSummarv 

See  Section  2.18.2.3.3. 

NewMission 

See  Section  2.18.2.6.1. 

GetDItem 

Standard  Dialoq  Manaqer  function  for  Macintosh. 

ShowMission 

See  Section  2.18.2.2.2. 

Table  2.18-53  ScheduleEvent  Information. 

2.18.2.8  setup. c 

Development:SIMNET:MCC:CAS  :setup.c 

setup.c  initializes  the  CAS  application  at  start-up. 

2.18.2.8.1  Setup 

SetUp  initializes  the  SIMNET  Close  Air  Support  application.  The  toolbox  is  intialized,  the 
SIMNET  Resources  and  CAS  Pictures  files  are  opened,  the  Help  Manager  is  intialized,  and 
the  dialogs  are  initialized.  The  function  call  is  SetUp().  Table  2.18-54  describes  the 
internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

errCode 

int 

Standard  C  type. 

finalTicks 

lonq 

Standard  C  type. 

Calls 

Function 

Where  Described 

InitToolbox 

See  Section  2.22.1.20.1. 

Zoomlnit 

See  Section  2.22.1.47.1. 

OpenResFile 

Standard  Resource  Manaqer  function  for  Macintosh. 

MenuBarTitle 

See  Section  2.22.1.43.1. 

Delay 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

ExitToShell 

Standard  Seqment  Loader  function  for  Macintosh. 

DeepShit 

See  Section  2.22.1.8.2. 

helpinit 

See  Section  2.22.1.19.1. 

SystemFailure 

See  Section  2.22.1.8.1. 

SetUpCondition 

See  Section  2.18.2.1.1. 

SetUpDialoq 

See  Section  2.18.2.2.1. 

SeiJpSchedule 

See  Section  2.18.2.7.1. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.18.2.5.1. 

Table  2.18-54  Setup  Information. 
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2.18.3  Appearance  of  CAS  Console  User  Interface 


2.18.3.1  CAS  Pictures 

Development;SIMNET:MCC:CAS:CAS  Pictures 

CAS  Pictures  contains  resources  that  determine  the  appearance  of  the  CAS  application's 
user  interface. 
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2.19  The  CEW  (Combat  Engineering  Workstation)  Console 


CEW  (Combat  Engineering  Workstation)  Console 
1.19 


CEW 

Console 

Definitions 

1.19.1 


CEW 

Console 

Software 

1.19.2 


Dialog  Lists 


Minefield  CEW 

Geometry  Ot^ects 

1.19.4  1.19.5 


.wersion.h 

1.19.1.1 

XEWMac.h 

1.19.1.2 

XEW.h 

1.19.1.3 

-SimnetTypes.h 

1.19.1.4 

.j’esourc.h 

1.19.1.5 


-main.c 

1.19.2.1 


■rfnenus.c 

1.19.2.2 


■jCannedStuff.c  ^x>ly_are 
1.19.3.1  a.c 

1.19.4.1 

.CI^kDialogsc 
1.19  3.2  ^,^4.2 


-DialogField 

Support.c 

1.19.3.3 
-DoAbout.c 

1.19.3.4 


.HotSpots.c 

1.19.3.5 


segjntrs 

etc 

1.19.4.3 
—segjntrs 

ct.h 

1.19.4.4 


XheckList.h 

1.19.5.1 

-  Checklist,  h 

1.19.5.2 

-ComWindows.c 

1.19.5.3 

-ComWindows.h 

1.19.5.4 

J3ialog_Window.c 

1.19.5.5 


-ResourceObj  c 
1.19.5.9 


-  ResourceObj  .  h 

1.19.5.10 

-ServiceObj.c 

1.19.5.11 

-ServiceObj.h 

1.19.5.12 

..Simple_Windows.c 

1.19.5.13 


-console. h 
1.19.1.6 


-Refresh.c 
1.19  3  6 

-Resltem.c 

1.19.3.7 

■  ResStatusWindow.c 
1.193.8 

-StatusSupport.c 

1.19.3.9 


-Dlalog_Window. 

h 

1.19.5.6 
-MissionObj.c 

1.19.5.7 

.MissionObj  h 
1.19.5  8 


-  Simple_Windows.  h 

1.19.5.14 


-TextListc 

1.19.5.15 


.TextListh 

1.19.5.16 


.Utils.c 

1,19.3.10 


Figure  2.19-1:  CEW  (Combat  Engineering  Workstation) 
Console  Structure. 
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2.19.1  CEW  Console  Derinitions 


2.19.1.1  version.h 

Development:  SIMNET:MCC:CEW :  version.h 

version.h  defines  the  version  of  the  CEW  Macintosh  application  to  be  compiled. 

2.19.1.2  CEWMac.h 

Development:SIMNET  :MCC:CEW:CEWMac.h 

CEWMac.h  is  the  header  file  used  by  all  of  the  CEW  source  code  files  in  the  CEW 
Macintosh  application.  Table  2.19-1  describes  the  variables  used  by  CEWMac.h. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

totalResources 

extern  short 

Standard  C  type. 

terrainMap 

extern  TerrainMap 

Development:SIMNET  :libmac: 
map.h 

leqalGEM  SSDe  nsitie  s 

extern  array  of  float 

Standard  C  type. 

llil  III  llillilll  Hill  nil'— 

extern  array  of  short 

Standard  C  type. 

breach_availList 

extern  pointer  to  CheckList 

Development:SIMNET  :CEW: 
CheckList. h 

move_availList 

extern  pointer  to  CheckList 

DevelopmentiSIMNET  :CEW: 
CheckList. h 

emplace_availList 

extern  pointer  to  CheckList 

DevelopmentiSIMNET  :CEW: 
CheckList. h 

stat_emplace_availList 

extern  pointer  to  CheckList 

Developmenf.SIMNET  :CEW; 
CheckList. h 

stat_breach_availList 

extern  pointer  to  CheckList 

Development:SIMNET;CEW; 
CheckList. h 

stat_mo  ve_avai  1  List 

extern  pointer  to  CheckList 

Development:SIMNET:CEW: 
CheckList. h 

cewResources 

extern  pointer  to  array  of 
ResourceObi 

Development:SIMNET:CEW; 
ResourceObi. h 

review_dlog 

extern  pointer  to 

DialoqWindow 

DevelopmentiSIMNET  :CEW: 
Dialoq  Windows. h 

emplace_dlog 

extern  pointer  to 

DialoqWindow 

Development:SIMNET  ;CEW; 
Dialoq  Window s.h 

main_window 

extern  pointer  to  ComWindow 

DevelopmentiSIMNET  :CEW: 
ComWindows.h 

cew  Mission 

extern  pointer  to  array  of 
MissionObj 

DevelopmentiSIMNE  r  ;CEW 
MissionObj. h 

Table  2.19-1  CEWMac.h  Variable  Information. 

2.19.1.3  CEW.h 

Devel’opment:SlMNET:MCC:CEW:CEW.h 

CEW.h  defines  the  MCC  SIMNET  Combat  Engineering  Workstation  (CEVv'i  paraineter.s 
and  interfaces. 
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2.19.1.4  SimnetTypes.h 

DeveIopment:SIMNET:MCC;CEW  rSimnetTypes.h 

SimnetTypes.h  contains  a  type  definition  of  the  UTMCoordinates  array.  Table  2.19-2 
describes  the  variables  used  by  SimnetTypes.h. 


1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

UTMCoordinates 

unsiqned  array  of  9  char 

Standard  C  type. 

Table  2.19-2  SimnetTypes.h  Variable  Information. 

2.19.1.5  resource.h 

Development:SIMNET  :MCC:CEW  :resource.h 

resource.h  contains  the  Mac  resource  IDs  for  the  CEW. 

2.19.1.6  console. h 

Development:SIMNET:MCC:CEW  xonsole.h 

console.h  defines  things  relevant  to  communication  between  the  Masscomp  host  and  the 
Macintosh  console.  Table  2.19-3  describes  the  variables  used  by  console.h. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

hostSocket 

extern  long 

Standard  C  type. 

Table  2.19-3  console.h  Variable  Information. 


2.19.2  CEW  Console  Software 


2.19.2.1  main.c 

Development:SIMNET:MCC:CEW:main.c 

main.c  contains  the  CEW  application's  program  entry  point  and  main  event  loop.  Table 
2.19-4  describes  the  variables  used  by  main.c. 
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Variable 


main_window 


emplace_dlog 


select_dlog 


breach_dlog 


move_dlog 


stat_bmplace 


stat_breach 


stat_move 


review_dlog 


missionList 


cewMission 


cewResources 


serviceq 


nextMission 


totalResources 


authors 


version 


application 


atpSocket 


Variables 


pointer  to  ComWindow 


pointer  to  OialogWindow 


pointer  to  OialogWindow 


pointer  to  OialogWindow 


pointer  to  OialogWindow 


pointer  to  OialogWindow 


pointer  to  OialogWindow 


pointer  to  OialogWindow 


pointer  to  OialogWindow 


pointer  to  TextList 


pointer  to  array  of 

NUM_OF_MISSION 

^^issionOb^ 


pointer  to  array  of 

NUM_OF_RESOURCES 

ResourceObi 


pointer  to  ServiceObj 


short 


short 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


extern  short 


\rs. 

lltS 

\n 

Ills 


Where  Tvoedef  Declared 


OevelopmentiSIMNET  :CEW: 
ComWindows.h 


Oevelopment:SIMNET  ;CEW: 
OialOQ  Windows.h 


Oevelopment;SIMNET  ;CEW: 
OialOQ  Windows.h 


Oevelopment:SIMNET  :CEW; 
Oiatoa  Windows.h 


OevelopmentrSIMNET  ;CEW: 
Oialoa  Windows.h 


Oevelopment:SIMNET  :CEW; 
Oialoa  Windows.h 


Oevelopment:SIMNET  :CEW: 
Oialoa  Windows.h 


OevelopmentiSIMNET  :CEW: 
Oialoa  Windows.h 


OevelopmentiSIMNET  :CEW; 
Oialoa  Windows.h 


OevelopmentiSIMNET  :CEW; 
TextList. h 


Oeveiopment.SIMNET  :CEW; 
MissionObj.h 


Oevelopment:SIMNET  :CEW; 
ResourceObj.h 


OevelopmentiSlMNET  ;CEW: 
ServiceObi  h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Table  2.19-4  main.c  Variable  Information. 

2.19.2.1.1  main 

main  is  the  program  entry  point.  The  function  call  is  main().  Table  2.19-5  describes  the 
internal  variables  used  and  functions  called  using  this  function. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

r 

Reel 

Development;THINK  C: 

Mac  #includes:MacTypes.h 

r1 

Reel 

OevelopmentTHINK  C: 

Mac  #includes;Mac Types. h 

tempstr 


testmp 


short 


array  of  255  char 


MapCoordi  nates 


Standard  C  type. 


Standard  C  type 


Development:SIMNET  :libmac 
map.h 
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Calls 

Function 

Where  Described 

OpenResFile 

Standard  Resource  Manaqer  function  for  Macintosh. 

Notify 

See  Section  2.19.3.4.4. 

ExitToSheil 

Standard  Segment  Loader  function  for  Macintosh. 

Macinits 

See  Section  2.19.2.1.3. 

ProcessRequest 

See  Section  2.19.2.1.5. 

SetUpAppleTalk 

See  Section  2.22.1.3.1. 

DownloadTerrainMap 

See  Section  2.22.1.3.4. 

LoadCannedTerrainMap 

See  Section  2.19.3.1.1. 

LoadCannedResources 

See  Section  2.19.3.1.2. 

ComWindow  "initial 

See  Section  2.19.5.3.3. 

ComWi  ndow :  :show 

See  Section  2.19.5.3.1. 

SetRect 

Standard  Quickdraw  function  for  Macintosh. 

TextList:;init 

See  Section  2.19.5.15.1. 

ShowWait 

See  Section  2.22.1.45.1. 

InstallCtock 

See  Section  2.22.1.6.4. 

MainEventLoop 

See  Section  2.19.2.1.2. 

Table  2.19-5  main  Information. 


2.19.2.1.2  MainEventLoop 

MainEventLoop  processes  incoming  events.  The  function  call  is  MainEventLoopO.  Table 
2.19-6  describes  the  internal  variables  used  and  functions  called  using  this  function. 


Variable 


myEvent 


eventpt 


Internal  Variables 


e 


EventRecord 


wwindow 


windowcode 


WindowRr 


Where  Tyoedef  Declared 


DevelopmentiTHINK  C: 
Mac  #includes:EventMar.h 


DevelopmtjnLTHINK  C. 
Mac  #includes:MacTvDes.h 


Standard  C  tvoe. 


Development:THINK  C: 
Mac  #jncludes:MacTyDes.h 


Standard  C  t 


Development:THINK  C: 
Mac  #includes:MacTvpes.h 


Development:THINK  C: 
Mac  #includes:MacTvpes.h 


Development:THINK  C: 

Mac  #includes:WindowMQr.h 


Standard  C  type. 
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Calls 

Function 

Where  Described 

SvstemTask 

Standard  Desk  Manager  function  for  Macintosh. 

UpdateClock 

See  Section  2.22.1.6.2. 

ServiceObj ;  ;UDdateQs 

See  Section  2.19.5.11.6. 

GetNext  Event 

Standard  Toolbox  Event  Manager  function  for  Macintosh. 

DoAbout 

See  Section  2.19.3.4.2. 

MacQuit 

See  Section  2.19.2.1.4. 

DoMenu 

See  Section  2.19.2.2.2. 

HiliteMenu 


DoResourceStatus 


Find  Window 


MenuSelect 


SystemClick 


HiliteWindow 


Select  Window 


SetPort 


GlobalToLocal 


Swindow.'.eoual 


ComWindow-CheckHotSoot 


TextList::List1  Click 


Swindow;:GetWindowPtr 


TextLisl'.'.GetCellRect 


ZoomRect 


ReviewSelection 


NetworkEventHandler 


Standard  Menu  Manager  function  for  Macintosh. 


Standard  Menu  Manager  function  for  Macintosh. 


See  Section  2.19.3.8.1. 


Standard  Window  Manager  function  for  Macintosh. 


Standard  Menu  Manager  function  for  Macintosh. 


Standard  Desk  Manager  function  for  Macintosh. 


Standard  Window  Manager  function  for  Macintosh. 


Standard  Window  Manager  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


See  Section  2.19.5.13.8. 


See  Section  2.19.5.3.4. 


See  Section  2.19.5.15.12. 


See  Section  2.19.5.13.10. 


See  Section  2.19.5.15.4. 


See  Section  2.22.1.47.2. 


See  Section  2.19.3.2.15. 


See  Section  2.22.1.3.5. 


Calted  B 


Function 

Where  Described 

main 

See  Section  2.19.2.1.1. 

Table  2.19-6  MainEventLoop  Information. 

2.19.2.1.3  Macinits 

Macinits  intializes  the  SIMNET  Combat  Engineer  Workstation  application.  The  master 
pointers  for  handles  in  the  Memory  Manager  are  made,  the  system  heap  is  grown,  the  event 
queue  is  flushed,  and  the  quickdraw  is  intialized.  The  random  number  generator  is  seede  ' 
the  pull-down  menus  arc  set  up,  the  service  queue  is  intialized,  and  the  dialogs  are  set  up 
The  function  call  is  Maclnit.s().  Table  2. 19-7  describes  the  internal  variables  used  and 
functions  called  using  this  function. 
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Calls 

Function 

Where  Described 

MoreMasters 

Standard  Memory  Manaqer  function  for  Macintosh. 

MaxAppIZone 

Standard  Memory  Manaqer  function  for  Macintosh. 

FlushEvents 

Standard  Operating  System  MerTx>ry  Manager  function  for 
Macintosh. 

InitGraf 

Standard  Quickdraw  function  for  Macintosh. 

InitFonts 

Standard  Font  Manaqer  function  for  Macintosh. 

InitWindows 

Standard  Window  Manaqer  function  for  Macintosh. 

InitMenus 

Standard  Menu  Manaqer  function  for  Macintosh. 

TEInit 

Standard  TextEdit  function  for  Macintosh. 

InitDialoqs 

Standard  Dialog  Manaqer  function  for  Macintosh. 

InitCursor 

Standard  Quickdraw  function  for  Macintosh. 

Zoomlnit 

See  Section  2.22.1.47.1. 

helpinit 

See  Section  2.22.1.19.1. 

GetDateTime 


SetUoMenus 


ServiceObi::init 


Dialoa  Window;:!  nit 


DialoaWindow;:SetUserltem 


See  Section  2.19.3.4.4. 


Standard  Ooeratino  System  Utility  tunction  for  Macintosh. 


See  Section  2.19.2.2.1. 


See  Section  2.19.5.11.1. 


See  Section  2.19.5.5.1. 


See  Section  2.19.5.5.13. 


Called  B 


Function 

Where  Described 

main 

See  Section  2.19.2.1.1. 

Table  2.19*7  Macinits  Information. 

2.19.2.1.4  MacQuIt 

MacQuit  quits  the  SIMNET  Combat  Engineer  Workstation  application.  The  function  call  is 
MacQuit().  Table  2.19-8  describes  the  internal  variables  used  and  functions  called  using 
this  function. 


Variable 


Function 


TextList ;  iListDispose 


Swindow::quit 


ATPCIoseSocket 


ExitToShell 


Function 


MainEventLoo 


DoMenu 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard  C  type. 


Calls 


Where  Described 


See  Section  2.19.5.15.3. 


See  Section  2.19.5.13.3. 


Standard  AppleTalk  Manaoer  function  for  Macintosh. 


Standard  Seqment  Loader  function  for  Macintosh. 


Called  B 


Where  Described 


See  Section  2.19.2.1.2. 


See  Section  2.19.2.2.2. 


Table  2.19*8  MacQuit  Information. 
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2.19.2.1.5  ProcessRequest 

ProcessRequest  processes  a  request  received  from  the  MCC  host,  hdl  is  the  handle  of  the 
request  from  the  host.  The  function  call  is  ProcessRequest(hdl).  Table  2.19-9  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

hdl 

register  Handle 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

P 

register  Rr 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

errCode 

short 

Standard  C  type. 

but 

array  of  100  char 

Standard  C  type. 

tempname 

array  of  255  char 

Standard  C  type. 

kind 

Iona 

Standard  C  type. 

speed 

short 

Standard  C  type. 

ccv 

long 

Standard  C  type. 

i 

short 

Standard  C  type. 

foos 

Str255 

DevelopmentTHINK  C; 

Mac  #includes:MacTypes.h 

wamStr 

Str255 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes  h 

nameStr 

Str255 

DevelopmentTHINK  C; 

Mac  #includes;MacTvpes.h 

miss 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ATPError 

See  Section  2.22.1.3.6. 

ATPResponse 

Standard  AppleTalk  Manager  function  for  Macintosh. 

SetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh 

ThrowWait 

See  Section  2.22.1.45.2. 

ResourceObi::init 

See  Section  2.19.5.9.1. 

ResourceObi;:SetPosition 

See  Section  2.19.5.9.4. 

ResourceObj  :GetCCVNumbe 
r 

See  Section  2.19.5.9.3. 

Notify 

See  Section  2.19.3.4.4. 

ResourceObi:;SetSlatus 

See  Section  2.19.5.9.11. 

ResourceObj-GetName 

See  Section  2.19.5.9.10. 

ResourceObi::GetMission 

See  Section  2.19.5.9.5. 

MissionObi::GetStatus 

See  Section  2.19.5.7.21. 

MissionObj::ResetMission 

Time 

See  Section  2.19.5.7.17. 

Restart 

Standard  Operating  System  Utility  function  for  Macintosh 
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1  Called  Bv  1 

Function 

Where  Described 

main 

See  Section  2.19.2.1.1. 

Table  2.19-9  ProcessRequest  Information. 

2.19.2.1.6  GetTerrainBounds 

GetTerrainBounds  sends  a  message  to  the  MCC  host  requesting  information  about  the 
boundary  limits  of  the  CEW  terrain.  The  function  call  is  GetTerrainBounds().  Table  2.19- 
10  describes  the  internal  variables  used  and  functions  called  using  this  function. 


I  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

ab 

register  ABRecHandle 

DevelopmentrTHINK  C: 

Mac  #includes;Appletalk.h 

n 

char 

Standard  C  type. 

errCode 

short 

Standard  C  type. 

theBounds 

CEWBoundsResponse 

DevelopmentiSiMNET  :CEW; 
CEW.h 

tempStr 

Str255 

Development;THINK  C: 

Mac  #includes;MacTypes.h 

Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

SetUpATPRequest 

See  Section  2.22.1.3.2. 

ATPError 

See  Section  2.22.1.3.6. 

ATPResponse 

Standard  Appletalk  Manager  function  for  Macintosh. 

DisposHandle 

Standard  Memory  Manager  function  for  Macintosh. 

Notify 

See  Section  2.19.0.4.4. 

Table  2.19-10  GetTerrainBounds  Information. 

2.19.2.2  menus. c 

Development:SIMNET:MCC:CEW:menus.c 

menus.c  contains  routines  that  implement  the  menus  for  the  CEW  Macintosh  console. 
Table  2.19-1 1  describes  the  variables  used  by  menus.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

comMenu 

array  of  5  MenuHandle 

Development:THINK  C: 

Mac  #includes;MenuMgr.h 

main_window 

extern  pointer  to  ComWindow 

Development:SIMNET;CEW: 

ComWindows.h 

Table  2.19-11  menus.c  Variable  Information. 
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2.19.2.2.1  SetUpMenus 


SetUpMenus  sets  up  the  menu  bar  for  the  CEW  console.  The  function  call  is 
SetUpMenus().  Table  2.19-12  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

NewMenu 

Standard  Menu  Manaaer  function  for  Macintosh. 

AppendMenu 

Standard  Menu  Manager  function  for  Macintosh. 

AddResMenu 

Standard  Menu  Manager  function  for  Macintosh. 

InsertMenu 

Standard  Menu  Manager  function  for  Macintosh. 

GetMenu 

Standard  Menu  Manager  function  for  Macintosh. 

DrawMenuBar 

Standard  Menu  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

Macinits 

See  Section  2.19.2.1.3. 

Table  2.19-12  SetUpMenus  Information. 

2.19.2.2.2  DoMenu 

DoMenu  handles  menu  selections,  menuresult  contains  the  specifiec  menu  ID,  and  the 
menu  item.  The  function  call  is  DoMenuQ.  Table  2.19-13  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameter 


menuresult 


Variable 


menuid 


Item 


daname 


cport 


refnum 


Parameters 


Internal  Variables 


e 


short 


short 


array  of  255  char 


GrafRr 


Where  Tvoedef  Declared 


Standard  C  type. 


Where  Tynedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Development;THINK  C: 
Mac  #includes;Quickdraw.h 


Standard  C  type. 


Calls 

Function 

Where  Described 

HiWord 

Standard  Toolbox  Utility  function  for  Macintosh. 

LoWord 

Standard  Toolbox  Utility  function  for  Macintosh. 

Getitem 

Standard  Menu  Manager  function  for  Macintosh. 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

OpenDeskAcc 

Standard  Desk  Manager  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

HiliteMenu 

Standard  Menu  Manager  function  for  Macintosh. 

DoAbout 

See  Section  2.19.3.4.2. 

MacQuit 

See  Section  2.19.2.1.4. 

SysBee 


NotimpDialo 


Standard  Ooeratino  System  Uttllity  function  for  Macintosh 


See  Section  2.19.3.4.3. 
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Called  Bv 

Function 

Where  Described 

MainEventLoop 

See  Section  2.19.2.1.2. 

Table  2.19-13  DoMenu  Information. 

2.19.3  Dialog  Lists  of  Assets 

2.19.3.1  CannedStuff.c 

Development:SIMNET:MCC:CEW  :CannedStuff.c 

2.19.3.1.1  LoadCannedTerrainMap 

LoadCannedTerrainMap  loads  in  a  canned  terrain  map  for  the  demo  version  of  the  CEW. 
The  function  call  is  LoadCannedTerrainMap().  Table  2.19-14  describes  the  functions 
which  call  this  function. 


1  Called  Bv  1 

Function 

Where  Described 

main 

See  Section  2.19.2.1.1. 

Table  2.19-14  LoadCannedTerrainMap  Information. 
2.19.3.1.2  LoadCannedResources 

LoadCannedResources  loads  in  a  canned  set  of  CEW  assets  for  the  demo  version.  The 
function  call  is  LoadCannedResourcesQ.  Table  2.19-15  describes  the  internal  variables 
used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

point 

LongPt 

Development:SIMNET  :libmac: 
lonqpt.h 

Calls 

Function 

Where  Described 

ResourceObi::init 

See  Section  2.19.5.9.1. 

ResourceObi::SetPosition 

See  Section  2.19.5.9.4. 

ResourceObj::SetStatus 

See  Section  2.19.5.9.11. 

Called  Bv 

Function 

Where  Described 

main 

See  Section  2.19.2.1.1. 

Table  2.19-15  LoadCannedResources  Information. 
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2.19.3.2  CheckDialogs.c 
DevelopmentrSIMNET  :MCC:CEW:CheckE>ialogs.c 

CheckDialogs.c  contains  routines  for  implementing  dialogs.  Table  2.19-16  describes  the 
variables  us^  by  CheckDialogs.c. 


I  Variables  1 

Variable 

Where  Typedef  Declared 

serviceq 

extern  pointer  to  ServiceObj 

Deyelopment:SIMNET:CEW: 
ServiceObj.  h 

missionList 

extern  pointer  to  TextList 

Development:SIMNET:CEW: 
TextList. h 

III  MUM  lllllllimil  — 

array  of  short 

Standard  C  type. 

leaalGEMSSDensities 

array  of  float 

Standard  C  type. 

time  modified 

short 

Standard  C  type. 

Table  2.19-16  CheckDialogs.c  Variable  Information. 

2.19.3.2.1  isLegalGEMSSDensity 

isLegalGEMSSDensity  determines  if  a  density  is  a  legal  value  for  GEMSS  vehicles.  The 
function  call  is  isLegalGEMSSDensity(dens).  Table  2.19-17  describes  the  parameters  used 
by  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

dens 

float 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

long 

Legal  density  value. 

FALSE 

long 

Illegal  density  value. 

1  Called  By  I 

Function 

Where  Described 

CheckEmplacement  Dialog 

See  Section  2.19.3.2.5. 

Table  2.19-17  isLegalGEMSSDensity  Information. 
2.19.3.2.2  isLegalMinefield 

isLegalMinefield  determines  if  a  minefield  is  of  a  legal  shape.  The  function  call  is 
isLegalMinefieldO.  Table  2.19-1 8  describes  the  internal  variables  used  and  funtiions 
call^  using  this  function. 
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Variable 


string 


Internal  Variables 


e 


short 


array  of  LongR 


Str255 


Where  Tvoedef  Declared 


Standard  C  t 


Development;SIMNET  :ljbmac; 
.h 


Return  Value 


TRUE 


FALSE 


Return  Values 


Meaning 


Legal  minefield. 


Illegal  minefield. 


Calls 

Function 

Where  Described 

DialogWindow;  :GetT  ext 

See  Section  2.19.5.5.7. 

UTMToLonaPt 

See  Section  2.19.3.3.5. 

seq  intrsct 

See  Section  2.19.4.3.1. 

See  Section  2.19.3.4.4. 


Called  B 


Function 

Where  Described 

CheckEmplacementDialoq 

See  Section  2.19.3.2.5. 

DetermineMines 

See  Section  2.19.3.2.14. 

Table  2.19-18  isLegalMinefield  Information. 

2.19.3.2.3  ReviewDialogHandler 

ReviewDialogHandler  is  a  template  for  handling  events  in  the  Review  dialogs.  The  routine 
is  not  called  in  the  application.  Table  2.19-19  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

diog 

pointer  to  DialogWindow 

DevelopmentiSIMNET  :CEW; 
Dialoq  Windows. h 

event 

EventRecord 

Development:THINK  C: 

Mac  #includes;EventMar.h 
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variable 


itemhit 


done 


lastitem 


c 


e 


h_item 


Ih  item 


Internal  Variables 


e 


short 


short 


short 


char 


short 


short 


Handle 


Handle 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Devetopment:THINK  C; 
Mac  #includes:MacTvDes.h 


DevelopmentiTHINK  C: 
Mac  #includes:MacTvDes.h 


Development:THINK  C: 
Mac  #includes:MacTypes.h 


DevelopmentiTHINK  C: 
Mac  #includes;MacTypes.h 


Development:THINK  C: 
Mac  #includes;MacTyDes.h 


Return  Values 

Return  Value 

Type 

Meaning 

START_MOVEMENT_NOW 

short 

Start  the  movement. 

END_MISSION_NOW 

short 

End  the  mission. 

START_ACTIVITY_NOW 

short 

Start  the  activity. 

Do  nothing;  event  was  not  a 
hot  ke 


Function 


SysBee 


Calls 


Where  Described 


Standard  Operating  System  Utility  function  for  Macintosh. 


Table  2.19-19  ReviewDialogHandler  Information. 
2.19.3.2.4  setEmpIacementTime 

setEmplacementTime  calculates  the  amount  of  time  it  will  take  to  emplace  the  minefield, 
given  the  assets  information  entered  in  the  dialog  specified  by  the  dialog  and  item 
parameters.  The  function  call  is  setEmplacementTime(dialogp,  item).  Table  2.19-20 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

dialogp 

pointer  to  DialogWindow 

Development;SIMNET  :CEW: 
Dialog  Windows. h 

item 

short 

Standard  C  type. 
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Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

itemjime 

DateTimeGroup 

Development:SIMNET  :libmac; 
dta.h 

emss  number 


cewPlatoon  number 


m57  number 


move  time 


activity  time 


er  hr 


at 


retval 


string 


stnng2 


sm  time 


sa  time 


f  time 


Str255 


Str255 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


DevelopmentiTHINK  C: 
Mac  #includes;MacTypes.h 


Development;TH!NK  C: 
Mac  #includes;MacTypes.h 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Return  Value 


retyal 


Return  Values 


Meanin 


The  amount  time  it  will  take  to 
emplace  the  minefield. 


Function 


TextList::GetCount 


ResourceOb 


DialooWindow.-.GetT  ext 


CheckList::GetState 


StrinqToDTG 


DTG  Elapsed 


DTGToStrin 


Dialoa  Wi  ndow :  :SetT  ext 


Calls 


Where  Described 


See  Section  2.19.5.15.5. 


See  Section  2.19.5.9.2. 


See  Section  2.19.5.5.7. 


See  Section  2.19.5.1.6. 


See  Section  2.22.1.15.2. 


See  Section  2.22.1.15.3. 


See  Section  2.22.1.15.1. 


See  Section  2.19.5.5.8. 


Function 


CheckEmplacementDialo 


Called  B 


Where  Described 


See  Section  2.19.3.2.5. 


Table  2.19-20  setEmplacementTime  Information. 
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2.19.3.2.5  CheckEmplacementDialog 

CheckEmplacementDialog  checks  the  validity  of  data  entered  in  the  Emplacement  Dialog 
fields.  The  shape  of  the  minefield  is  checked,  and  the  selected  assets  are  checked.  In 
addition,  the  routine  performs  calculations  of  the  mission  time  and  mine  requirements. 
The  function  call  is  CheckEmplacementDialog(dialogp,  item,  to_reset,  theEvent).  Table 
2.19-21  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


dialogp 


item 


to_reset 


theEvent 


Parameters 


pointer  to  DiaiogWindow 


short 


pointer  to  Boolean 


pointer  to  EventRecord 


Where  Tvoedef  Declared 


Development:SIMNET  :CEW: 
Dialoo  Windows.h 


Standard  C  type. 


DevelopmentTHINK  C: 
Mac  #includes:MacTvDes.h 


DevelopmentTHINK  C: 
Mac  #inciudes:EventMQr.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dtg 

DateTimeGroup 

Development;SIMNET  ;libmac; 
dta.h 

currentjtime 

DateTimeGroup 

Development:SIMNET;libmac; 

dta.h 

wp 

DialogRr 

Development;THINK  C; 

Mac  #includes;DialoaMar.h 

hjtem 

Handle 

Development;THINK  C; 

Mac  #includes;MacTypes.h 

box 

Rect 

Development;THINK  C; 

Mac  #includes;MacTypes.h 

string 

Str255 

Development.THINK  C; 

Mac  #includes;MacTypes.h 

string2 

Str255 

Development;THINK  C; 

Mac  #includes;MacTypes.h 

short 


short 


short 


short 


Str255 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


DevelopmentTHINK  C: 
Mac  #includes:MacTypes.h 


Return  Values 


Return  Value 


TRUE 


FALSE 


Type 


short 


Meaning 


Data  is  accepted;  user  is 
allowed  to  continue. 


Data  is  not  accepted;  the 
dialog  cannot  be  brought 
down. 
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1  Calls  1 

Function 

Where  Described 

DialogWindow:  :GetDialoaRr 

See  Section  2.19.5.5.16. 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

DialogWindow :  :GetT  ext 

See  Section  2.19.5.5.7. 

Notify 

See  Section  2.19.3.4.4. 

DialogWindow:  :GetValue 

See  Section  2.19.5.5.10. 

isLegalMinefield 

See  Section  2.19.3.2.2. 

TextList::GetCount 

See  Section  2.19.5.15.5. 

C  heckList :  :GetState 

See  Section  2.19.5.1.6. 

ResourceObj::GetKind 

See  Section  2.19.5.9.2. 

lllilllll  II  IIIIIIIII^M 

See  Section  2.19.3.2.1. 

DetermineMines 

See  Section  2.19.3.2.14. 

Get  DTG 

See  Section  2.22.1.15.4. 

DTGToString 

See  Section  2.22.1.15.1. 

Dialog  Wi  ndow :  :SetText 

See  Section  2.19.5.5.8. 

setEmplacementTime 

See  Section  2.19.3.2.4. 

Ch  eckvsCu  rrentTi  meStr 

See  Section  2.19.3.3.4. 

DialogWindow::Set\/alue 

See  Section  2.19.5.5.11. 

CheckList  Handler 

See  Section  2.19.3.7.2. 

CheckUTMString 

See  Section  2.19.3.3.1. 

HiliteWindow 

Standard  Window  Manager  function  for  Macintosh. 

Select  Window 

Standard  Window  Manager  function  for  Macintosh. 

Set  Port 

Standard  Quid<draw  function  for  Macintosh. 

Dialoo  Window::SelectText 

See  Section  2.19.5.5.9. 

ToUpper 

Macro  defined  in  Development:SIMNET:CEW:CheckDialoqs.c. 

l>liTJ!l!1ihiri"l  II  1  1  ^—1 

See  Section  2.19.3.3.2. 

1  NotImpDialoq 

See  Section  2.19.3.4.3. 

Table  2.19-21  CheckEmplacementDiaiog  Information. 


2.19.3.2.6  setBreachTime 

serBreachTime  calculates  the  amount  of  time  it  will  take  to  breach  a  lane,  given  the  assets 
information  entered  in  the  dialog  by  the  user.  The  dialog  is  specified  by  the  dialog  and  item 
parameters.  The  function  call  is  setBreachTime(dialogp,  item).  Table  2.19-22  describes 
the  parameters  used  and  functions  called  using  this  function. 


Parameter 


dialogp 


Parameters 


pointer  to  DialogWindow 


Where  Typedef  Declared 


Development:SIMNET:CEW: 
Dialoo  Windows. h 


Standard  C  t 
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Variable 


end_pt 


start _pt 


lineCharoe  number 


area 


move  time 


activity  time 


retvaf 


lenath 


string 


string2 


itemjime 


sm  time 


sa  time 


f  time 


charges 


Internal  Variables 


e 


LongPt 


LonyPt 


Str255 


Str255 


DateTimeGroup 


Where  Tvpedef  Declared 


DevelopmentiSIMNET  ilibmac; 
lonopt.h 


Oevelopment;SIMNET  ilibmac; 
lonoDt.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


DevelopmentiTHINK  C: 
Mac  #includes:MacTypes.h 


Development:THINK  C: 
Mac  #includes;MacTvpes.h 


Development:SIMNET  :libmac: 
dta.h 


Standard  C  tvoe. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Return  Value 


retval 


Return  Values 


Meanin 


The  amount  of  time  it  will  take 
to  breach  the  lane. 


Function 


TextList::GetCount 


CheckList::GetState 


ResourceObi::GetKind 


Dialog  Wi  ndow :  ;GetText 


DialogWindow :  ;SetText 


UTMToLongPt 


DistBetween2Pts 


NumToString 


Calls 


Where  Described 


See  Section  2.19.5.15.5. 


See  Section  2.19.5.1.6. 


See  Section  2.19.5.9.2. 


See  Section  2.19.5.5.7. 


See  Section  2.19.5.5.8. 


See  Section  2.19.3.3.5. 


See  Section  2.22.1.23.2. 


Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 


ResourceObj::DistanceToSec  I  See  Section  2.19.5.9.9. 


StringToDTG 


DTG  Elapsed 


DTGToStrin 


Notif 


See  Section  2.22.1.15.2. 


See  Section  2.22.1.15.3. 


See  Section  2.22.1.15.1. 


See  Section  2.19.3.4.4. 


Function 


CheckBreachDialo 


Called  B 


Where  Described 


See  Section  2.19.3.2.7. 


Table  2,19-22  sctBreachTime  Information. 


634 


BBN  Systems  and  Technologies 


MCCCSCI 


2.19.3.2.7  CheckBreachDialog 

CheckBreachDialog  checks  the  validity  of  data  entered  in  the  Breach  Dialog  fields.  In 
addition,  the  routine  performs  calculations  of  mission  time  requirements.  The  functicm  call 
is  Checl^reachDialog(dialogp,  item,  to_reset,  theEvent).  Table  2.19-23  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


dialogp 


item 


to_reset 


theEvent 


Parameters 


e 


pointer  to  DialogVvindow 


short 


pointer  to  Boolean 


pointer  to  EventRecord 


Where  Tvpedef  Declared 


Development;SIMNET  :CEW; 
Dialoa  Windows. h 


Standard  C  t 


Development:THINK  C: 
Mac  #includes:MacTvpes.h 


Development:THINK  C; 
Mac  #includes;EventMar.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dtg 

DateTimeGroup 

Development;SIMNET  :libmac: 
dta.h 

currenMime 

DateTimeGroup 

DevelopmentrSIMNET  :libmac: 
dtq.h 

wp 

DialogRr 

Development.THINK  C: 

Mac  #includes:DialoQMar.h 

end_pt 

LongPt 

Development;SIMNET  :libmac: 
lonqpt.h 

start J3t 

LongPl 

DevelopmentiSIMNET  :libmac; 
lonqpt.h 

hjtem 

Handle 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

box 

Rect 

Development;THINK  C: 

Mac  #includes:MacTypes.h 

string 

Str255 

Deyelopment;THINK  C: 

Mac  #includes:MacTypes.h 

string2 

Str255 

DevelopmentiTHINK  C; 

Mac  #includes:MacTypes.h 

lineCharoe  number 


e 


time  diff 


move  time 


activity  time 


ts 


unsianed  Ion 


unsioned  km 


Str255 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  t 


DevelopmentiTHINK  C: 
Mac  #includes;MacT 


Return  Values 

Return  Value 

Type 

Meaning 

TRUE 

short 

Data  is  accepted;  user  is 
allowed  to  continue. 

FALSE 

short 

Data  is  not  accepted;  the 
dialog  cannot  be  brought 
down. 
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Function 


DialooWindowiiGetDialoaRr 


GetDItem 


DialooWindow:  :GetT  ext 


UTMToLonoR 


TextList::GetCount 


CheckList::GetState 


ResourceObi;:GetKind 


Get  DTG 


DTGToStri 


Dia  loQ  Wi  ndow :  :SetT  ext 


setBreachTime 


CheckvsCurrentTimeStr 


DialoqWindow::SetValue 


Checklist  Handler 


CheckUTMStrin 


HiliteWindow 


Select  Window 


SetPort 


SellText 


ToUDDer 


NotimpDialo 


Catls 


Where  Described 


See  Section  2.19.5.5.16. 


Standard  Dialoa  Manaaer  function  for  Macintosh. 


See  Section  2.19.5.5.7. 


See  Section  2.19.3.3.5. 


See  Section  2.19.3.4.4. 


See  Section  2.19.5.15.5. 


See  Section  2.19.5.1.6. 


See  Section  2.19.5.9.2. 


See  Section  2.22.1.15.4. 


See  Section  2.22.1.15.1. 


See  Section  2.19.5.5.8. 


See  Section  2.19.3.2.6. 


See  Section  2.19.3.3.4. 


See  Section  2.19.5.5.11. 


See  Section  2.19.3.7.2. 


See  Section  2.19.3.3.1. 


Standard  Window  Manaaer  function  for  Macintosh. 


Standard  Window  Manaaer  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Dialoa  Manaaer  function  for  Macintosh. 


Macro  defined  in  Development:SIMNET:CEW:CheckDialoqs.c. 


See  Section  2.19.3.3.2. 


See  Section  2.19.3.4.3. 


Table  2.19*23  CheckBreachDialog  Information. 
2.19.3.2.8  CheckMoveDialog 

CheckMoveDialog  checks  the  validity  of  the  data  entered  in  the  Move  Mission  Dialog 
fields.  In  addition,  the  routine  performs  calculations  of  mission  time  requirements  (the 
length  of  time  it  takes  to  move  to  the  given  point).  The  function  call  is 
CheckMoveDialog(dialogp,  item,  to_reset,  theEvent).  Table  2.19-24  describes  the 
parameters  used  and  functions  called  using  this  function. 
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Variable 


e 


h  item 


string 


stnng2 


Internal  Variables 


e 


short 


Handle 


Str255 


Xiong 


move  time 


dtg 


time  diff 


ts 


current  time 


Str255 


short 


short 


DialogRr 


LongPt 


DateTimeGroup 


Str255 


DateTimeGroup 


Where  Tyoedef  Declared 


Standard  C  tvoe. 


DevelopmentiTHINK  C: 
Mac  '#includes;MacTvpes.h 


DevelopmentTHINK  C; 
Mac  #includes:MacTypes.h 


DevelopmentTHINK  C: 
Mac  #includes:MacTvpes.h 


Development:THINK  C: 
Mac  #includes;MacTvDes.h 


Standard  C  tvoe. 


Standard  C  t 


DevelopmenttTHINK  C: 
Mac  #includes;DialoaMqr.h 


Development:SIMNET  :libmac: 
lonapt.h 


Standard  C  type. 


DevelopmentrSlMNET  :libmac: 
dtq.h 


Standard  C  type. 


DevelopmentiTHINK  C: 
Mac  #includes:MacTvpes.h 


DevelopmentiSIMNET  ilibmac: 
dtq.h 


Return  Values 


Return  Value 


TRUE 


FALSE 


Type 


short 


Meaning 


Data  is  accepted;  user  is 
allowed  to  continue. 


Data  IS  not  accepted;  the 
dialog  cannot  be  brought 
down. 
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1  Calls  1 

Function 

Where  Described 

Dialog  Wi  ndow :  :Get  DialogRr 

See  Section  2.19.5.5.16. 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

DialogWindow:  :GetT  ext 

See  Section  2.19.5.5.7. 

UTMToLongPt 

See  Section  2.19.3.3.5. 

Notify 

See  Section  2.19.3.4.4. 

TextList::GetCount 

See  Section  2.19.5.15.5. 

CheckList::GetState 

See  Section  2.19.5.1.6. 

Get  DTG 

See  Section  2.22.1.15.4. 

DTGToString 

See  Section  2.22.1.15.1. 

Dialog  Wi  ndow :  :SetT  ext 

See  Section  2.19.5.5.8. 

DTG  Elapsed 

See  Section  2.22.1.15.3. 

CheckvsCurrentTimeStr 

See  Section  2.19.3.3.4. 

CheckUTMString 

See  Section  2.19.3.3.1. 

HiliteWindow 

Standard  Window  Manager  function  for  Macintosh. 

SelectWindow 

Standard  Window  Manager  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

SellText 

Standard  Dialog  Manager  function  for  Macintosh. 

ToUpper 

Macro  defined  in  Development;SIMNET:CEW:CheckDialoqs.c. 

ResourceObj :  ;DistanceToSec 
s 

See  Section  2.19.5.9.9. 

StrinqToDTG 

See  Section  2.22.1.15.2. 

Checklist  Handler 

See  Section  2.19.3.7.2. 

CheckDTGStrinq 

See  Section  2.19.3.3.2. 

NotImpDialoq 

See  Section  2.19.3.4.3. 

Table  2.19-24  CheckMoveDialog  Information.  ^ 

2.19.3.2.9  CheckMissionTypeDialog 

CheckMissionTypeDialog  checks  for  validity  of  user  input  in  the  Mission  Type  Dialog. 

The  OK  button,  Emplace  Button,  Breach  button,  and  Move  button  are  enabl^.  The 
Mission  Type  dialog  allows  the  user  to  choose  whether  the  mission  is  an  Emplacement, 

Breach,  or  Move  Mission.  The  function  call  is  CheckMissionTypeDialog(dialogp,  item, 
to_reset,  theEvent).  Table  2.19-25  describes  the  parameters  used  by  this  function. 


_ _ Parameters _ 

Parameter _ Type _ Where  Typedef  Declared 

dialogp  pointer  to  DialogWindow  Development:SIMNET:CEW: 

_ _ _ Dialog  Windows. h _ 

item _ short _ Standard  C  type. _ 

to_reset  pointer  to  Boolean  Development:THINK  C: 

_ Mac  #includes:MacTypes.h 

theEvent  pointer  to  EventRecord  DevelopmentiTHINK  C: 

_ _  Mac  #includes:EventMqr.h 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

short 

Data  is  accepted;  user  is 
allowed  to  continue. 

FALSE 

short 

Data  is  not  accepted;  the 
dialog  cannot  be  brought 
down. 

Table  2.19-25  CheckMissionTypeDialog  Information. 
2.19.3.2.10  CheckStatEmpIacementDialog 

CheckStatEmplacementDialog  checks  for  changes  made  in  the  Emplacement  dialog.  This 
function  is  not  currently  called  by  the  application.  The  function  call  is 
CheckStatEmplacementDialogCdialogp,  item,  to_reset,  theEvent).  Table  2.19-26  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialogp 

pointer  to  DialogWindow 

Development:SIMNET:CEW; 
Dialoa  Windows.h 

item 

short 

Standard  C  type. 

to_reset 

pointer  to  Boolean 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvpes.h 

theEvent 

pointer  to  EventRecord 

Development:THINK  C; 

Mac  #includes:EventMar.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

short 

The  changes  are  valid. 

FALSE 

short 

The  changes  are  not  valid. 

1  Calls  1 

Function 

Where  Described 

CheckList  Handler 

See  Section  2.19.3.7.2. 

li'l  illiil  1  II II 1 

See  Section  2.19.3.4.3. 

Table  2.19-26 


CheckStatEmplacementDialog  Information. 
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2.19.3.2.11  CheckStatBreachDialog 

CheckStatBreachDialog  checks  for  changes  made  in  the  Breach  dialog.  This  function  is 
not  currently  called  by  the  application,  "^e  function  call  is 

CheckStatBreachDialog(didogp,  item,  to_reset,  theEvent).  Table  2.19-27  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

dialogp 

pointer  to  DialogWindow 

Devetopmenf.SIMNET'.CEW; 
Dialoo  Windows. h 

item 

short 

Standard  C  type. 

to_reset 

pointer  to  Boolean 

Development'.THiNK  C; 

Mac  #includes;MacTypes.h 

theEvent 

pointer  to  EventRecord 

Development:THINK  C: 

Mac  tincludes’.EventMqr.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

short 

The  changes  are  valid. 

FALSE 

short 

The  changes  are  invalid. 

1  Calls  1 

Function 

Where  Described 

Checklist  Handler 

See  Section  2.19.3.7.2. 

NotImpOialoq 

See  Section  2.19.3.4.3. 

Table  2.19>27  CheckStatBreachDialog  Information. 

2.19.3.2.12  CheckStatMoveDialog 

CheckStatMoveDialog  checks  for  changes  in  the  Move  Mission  dialog.  This  function  is 
not  currently  called  by  the  application.  The  function  call  is  CheckStatMoveDialog(dialogp, 
item,  to_reset,  theEvent).  Table  2. 19-28  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

dialogp 

pointer  to  DialogWindow 

Development:SIMNET  ;CEW: 
Dialog  Windows. h 

item 

short 

Standard  C  type. 

to_reset 

pointer  to  Boolean 

Development:THINK  C; 

Mac  #includes:MacTyDes.h 

theEvent 

pointer  to  EventRecord 

DevelopmentTHINK  C; 

Mac  #includes:EventMqr.h 

Return  Values 

Return  Value 

Type 

Meaning 

TRUE 

short 

The  changes  are  valid 

FALSE 

short 

The  changes  are  invalid. 
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1  Calls  1 

Function 

Where  Described 

CheckList  Handler 

See  Section  2.19.3.7.2. 

NotImpDialoq 

See  Section  2.19.3.4.3. 

Table  2.19-28  CheckStatMoveDialog  Information. 


2.19.3.2.13  CheckReviewDialog 

CheckReviewDialog  checks  the  validity  of  events  in  the  Review  dialogs.  This  function  is 
not  currently  called  by  the  application.  The  function  call  is  CheckReviewDialog().  Table 
2.19-29  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


dialogp 


item 


to_reset 


thebvent 


Parameters 


e 


pointer  to  DialogWindow 


short 


pointer  to  Boolean 


pointer  to  EventRecord 


Where  Tvpedef  Declared 


Development:SIMNET:CEW; 
Dialoa  Windows.h 


Standard  C  type. 


Development:THINK  C: 
Mac  #includes;MacTvDes.h 


Development:THINK  C: 
Mac  #includes;EventMqr.h 


Return  Values 


Return  Value 


TRUE 


FALSE 


Type 


short 


short 


Meanin 


The  event  is  valid 


The  event  is  not  valid 


Function 


DialoqWindow;:SetValue 


Calls 


Where  Described 


See  Section  2.19.5.5.11. 


Table  2.19-29  CheckReviewDialog  Information. 


2.19.3.2.14  DetermineMines 


DetermineMines  determines  the  number  of  mines  it  would  take  to  make  the  given  density  of 
minefield  that  the  user  entered.  The  user  entered  data  is  located  in  the  dialog  specified  by 
the  parameters,  dialogp  and  item.  The  function  call  is  DetermineMines(dialogp,  item). 
Table  2.19-30  describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

string 

Str255 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

stiing2 

Str255 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

den 

array  of  3  float 

Standard  C  type. 

area 

unsigned  long 

Standard  C  type. 

dis 

unsigned  long 

Standard  C  type. 

anf 

unsigned  long 

Standard  C  type. 

apb 

unsigned  long 

Standard  C  type. 

at 

unsigned  long 

Standard  C  type. 

dis1 

unsigned  long 

Standard  C  type. 

i 

short 

Standard  C  type. 

width 

short 

Standard  C  type. 

count 

short 

Standard  C  type. 

Pt 

array  of  5  LongR 

Development  -.SIM  N  ET  -.libmac ; 
longpt.h 

index 

short 

Standard  C  type. 

dioaitem 

short 

Standard  C  type. 

d area 

double 

Standard  C  type. 

I  Calls  I 

Function 

Where  Described 

isLeaalMinefield 

See  Section  2.19.3.2.2. 

OialoqWindow;;GetValue 

See  Section  2.19.5.5.10. 

Di  aloq  Wi  ndow :  :GetT  ext 

See  Section  2.19.5.5.7. 

UTMToLonqPt 

See  Section  2.19.3.3.5. 

DistBetween2Pts 

See  Section  2.22.1.23.2. 

poly  area 

See  Section  2.19.4.1.1. 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

Dialog  Window :  :SetT  ext 

See  Section  2.19.5.5.8. 

I  Called  By  I 

Function 

Where  Described 

CheckEmplacementDialoq 

See  Section  2.19.3.2.5. 

Table  2.19-30  DetermineMines  Information. 

2.19.3.2.15  ReviewSelection 

ReviewSelection  sets  up  the  Review  dialogs.  The  review  dialogs  show  a  mission 
(specified  by  the  mission  number  num)  to  the  user.  The  routine  allows  the  user  access  to 
the  mission  data  based  on  the  status  of  the  mission.  If  the  mission  is  in  progress,  the  user 
may  only  show  the  mission  for  review.  If  the  mission  is  not  in  progress,  the  user  may 
either  show  the  mission,  edit  the  mission,  or  abort  the  mission.  The  routine  also  handles 
the  use  of  "hot  keys"  to  expedite  missions.  TRUE  is  returned  if  the  selection  was 
successfully  handled.  FALSE  is  returned  if  Uie  user  attempts  an  illegal  event,  i.e  tid  ing  to 
force  an  aborted  mission  to  execute.  The  function  call  is  ReviewSelection(num\  Table 
2.19-31  describes  the  parameters  used  and  functions  called  using  this  function. 
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Parameter 


Parameters 


Where  Tvpedef  Declared 


Standard  C  tvoe. 


Variable 


last  Button 


thisMission 


status 


currentjime 


okJ  start  time 


old  end  time 


new  end  time 


diff 


Internal  Variables 


e 


short 


short 


short 


DateTimeQroup 


unsioned  Ion 


unsigned  Ion 


unsigned  Ion 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  tvoe. 


OevelopmentiSIMNET.iibmac; 

dtg.h 


Standard  C  t 


Standard  C  tvoe. 


Standard  C  t 


Standard  C  t 


Return  Value 


TRUE 


FALSE 


Return  Values 


Type 


short 


short 


Meaning 


Successful. 


Unsuccessful. 


Function 


MissionObi;:GetStatus 


DialogWindow::SetValue 


Dialog  Window::Hiliteltem 


DialogWindow:  :activate 


Swindow::update 


DialogWindow::GetValue 


MissionObi;:show 


MissionObi;;edit 


MissionObj ;  ;SetStatus 


MissionObj ;  ;GetStartMoveTim 


MissionObi :  :GetEndTime 


Get  DTG 


MissionObj::SetStartMoveTim 


MissionObi::SetEndTime 


MissionObj:  :UpdateMissionStr 
ing 


ServiceObi:  :CheckQs 


Notif 


MissionObj;;GetStartActivityTi 

me 


MissionObj.’.SetStartActivityTi 


Calls 


Where  Described 


See  Section  2.19.5.7.21. 


See  Section  2.19.5.5.11. 


See  Section  2.19.5.5.12. 


See  Section  2.19.5.5.3. 


See  Section  2.19.5.13.4. 


See  Section  2.19.5.5.10. 


See  Section  2.19.5.7.4. 


See  Section  2.19.5.7.2. 


See  Section  2.19.5.7.20. 


See  Section  2.19.5.7.6. 


See  Section  2.19.5.7.8. 


See  Section  2.22.1.15.4. 


See  Section  2.19.5.7.9. 


See  Section  2.19.5.7.11. 


See  Section  2.19.5.7.5. 


See  Section  2.19.5.11.4. 


See  Section  2.19.3.4.4. 


See  Section  2.19.5.7.7. 


See  Section  2.19.5.7.10. 


Function 


MainEventLoo 


Called  B 


Where  Described 


See  Section  2.19.2.1.2. 


Table  2.19-31  ReviewSelection  Information. 
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2.19.3.3  DialogFieldSupport.c 

DevelopmentrSIMNET  :MCC:CEW  :DialogFieldSupport.c 

This  file  provides  routines  used  to  check  dialog  fields  data. 

2.19.3.3.1  CheckUTMString 

CheckUTMString  checks  the  validity  of  the  UTM  coordinate  passed  in  the  parameter, 
utmstring.  The  function  call  is  CheckUTMString(utmstring).  Table  2.19-32  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

utmstring 

UTMCoordinates 

Development:SIMNET  :CEW: 
SimnetTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

cStr 

pointer  to  char 

Standard  C  type. 

map 

MapCoordinates 

DevelopmentiSIMNET  ilibmac; 
map.h 

tempStr 

Str255 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

outStr 

Str255 

Development.THINK  C: 

Mac  #includes:MacTypes.h 

result 

short 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

TRUE 

short 

Valid  UTM  string. 

FALSE 

short 

Invalid  UTM  string. 

1  Calls  1 

Function 

Where  Described 

stpcpy 

See  Section  2.19.3.10.3. 

Notify 

See  Section  2.19.3.4.4. 

StringToMapCoordinates 

See  Section  2.22.1.26.1. 

Called  Bv 

Function 

Where  Described 

CheckEmplacementDialoa 

See  Section  2.19.3.2.5. 

CheckBreachDialOQ 

See  Section  2.19.3.2.7. 

See  Section  2.19.3.2.8. 

Table  2.19-32  CheckUTMString  Information. 

2.19.3.3.2  CheckDTGString 

CheckDTGString  checks  the  validity  of  the  DTG  string  passed  in  the  parameter,  dtgstring. 
The  function  call  is  CheckDTGString(dtgstring).  Table  2.19-33  describes  the  parameters 
used,  errors  returned  and  func  tions  called  using  this  function. 
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Parameter 


dtQstnn 


Parameters 


inter  to  char 


Where  Tvoedef  Declared 


Standard  C  t 


Internal  Variables 

Variable 

Where  Tvpedef  Declared 

dtg 

DateTimeGroup 

DevelopmentrSIMNET  :libmac; 
dtg.h 

tempStr 


cStr 


result 


array  of  255  char 


char 


short 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Return  Value 


TRUE 


FALSE 


Return  Values 


Type 


short 


short 


Meaning 


Valid  DTG  string. 


Invalid  DTG  string. 


Error  Name 


DTG  SUCCESS 


DTG  ERROR 


DTG  BAD  DAY 


DTG  BAD  HOUR 


DTG  BAD  MINUTE 


Errors 


Reason  for  Error 


Valid  DTG  stri 


Incorrect  date  time  orou 


Wrono  hour. 


Wrong  minute. 


Function 


StrinoToDTG 


Calls 


Where  Described 


See  Section  2.22.1.15.2. 


See  Section  2.19.3.4.4. 


Function 


CheckEmplacementDialo 


CheckBreachDialo 


CheckMoveDialo 


Called  B 


Where  Described 


See  Section  2.19.3.2.5. 


See  Section  2.19.3.2.7. 


See  Section  2.19.3.2.8. 


Table  2.19-33  CheckDTGString  Information. 

2.19.3.3.3  CheckvsCurrentTime 

CheckvsCurrentTime  compares  the  time  passed  in  the  parameter,  dtg,  with  the  current  time. 
If  dtg  is  later  than  or  equal  to  the  current  time,  TRUE  is  returned.  If  dtg  is  earlier  than  the 
current  time,  FALSE  is  returned.  The  function  call  is  CheckvsCurrentTime(dtg).  Table 
2.19-34  describes  the  parameters  used,  errors  returned  and  functions  called  using  this 
function. 


Parameters 


Parameter 


dtg 


DaleTimeGroup 


Where  Tvpedef  Declared 


Development:SIMNET:libmac: 

dta.h 
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Variable 


now 


Internal  Variables 


unsianed  ion 


Where  Tvoedef  Declared 


Standard  C  t 


Return  Values 


Return  Value 


TRUE 


FALSE 


Meanin 


dtg  is  later  than  or  equal  to  the 
current  time. 


dtg  is  earlier  than  the  current 
time. 


Function 


GetDateTime 


Calls 


Where  Described 


Standard  Ooeratinq  System  Utility  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

Ch  eckvsCu  rrentTi  meSt  r 

See  Section  2.19.3.3.4. 

Table  2.19-34  CheckvsCurrentTime  Information. 

2.19.3.3.4  CheckvsCurrentTimeStr 

CheckvsCurrcntTimeStr  compares  the  time  string  passed  in  the  parameter,  dtgstring,  with 
the  current  time.  If  dtgstring  is  later  than  or  equal  to  the  current  time,  TRUE  is  returned. 
If  dtgstring  is  earlier  than  the  current  time,  FALSE  is  returned.  The  function  call  is 
CheckvsCurrentTimeStrfdtgstring).  Table  2.19-35  describes  the  parameters  used  and 
funcdons  called  using  this  function. 


Parameter 


dtqstnn 


Parameters 


inter  to  char 


Where  Typedef  Declared 


Standard  C  type. 


Variable 


dtg 


tempStr 


cStr 


result 


Internal  Variables 


DateTimeGroup 


array  of  255  char 


inter  to  char 


short 


Where  Typedef  Declared 


DevelopmentiSIMNET  :libmac: 
dtq.h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Return  Values 


Return  Value 


CheckvsCurrentTime(dtg) 


Type 


short 


Meaning 


If  TRUE,  dtgstring  \s  later  than 
or  equal  to  the  current  time; 
If  FALSE,  dtgstring  \s  earlier 
than  the  current  lime. 


Function 


StrinqToDTG 


CheckvsCurrentTime 


Calls 


Where  Described 


See  Section  2.22.1.15.2. 


See  Section  2.19.3.3.3. 
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Called  By 

Function 

Where  Described 

CheckEmplacementDialoQ 

See  Section  2.19.3.2.5. 

CheckBreachDialoq 

See  Section  2.19.3.2.7. 

CheckMoveDialog 

See  Section  2.19.3.2.8. 

Table  2.19-35  CheckvsCurrentTimeStr  Information. 


2.19.3.3.5  UTMToLongPt 

UTMToLongPt  converts  a  UTM  coordinate,  utmstring,  to  a  LongPt  coordinate.  The 
parameter,  pt,  is  filled  in  with  the  long  (x,y)  point.  The  function  call  is 
UTMToLongPt(utmstring,  pt).  Table  2.19-36  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameters 


Parameter 


utmstring 


UTMCoordinates 


pointer  to  LongPt 


Where  Tvoedef  Declared 


DevelopmentiSIMNET  :CEW: 
SimnetTvoes.h 


DevetopmentiSIMNET  ilibmac; 
.h 


Variable 


map 


Internal  Variables 


e 


MapCoordinates 


IEI73 


pointer  to  char 


Where  Tvoedef  Declared 


Development:SIMNET:libmac: 

mao.h 


Standard  C  type. 


Function 


StrinoToMapCoordinates 


SetLonqPt 


Calls 


Where  Described 


See  Section  2.22.1.26.1. 


See  Section  2.22.1.23.5. 


Function 


isLeoalMinefield 


setBreachTime 


CheckBreachDialo 


CheckMoveDialo 


DetermineMines 


GetDisTime 


MissionObj :  iResetMission 
Time 


MissionObj ;  :Send  Emplace 
ment 


MissionObi::SendBreach 


ResourceObj-DistanceToSec 

s 


Called  B 


Where  Described 


See  Section  2.19.3.2.2. 


See  Section  2.19.3.2.6. 


See  Section  2.19.3.2.7. 


See  Section  2.19.3.2.8. 


See  Section  2.19.3.2.14. 


See  Section  2.19.3.3.6. 


See  Section  2.19.5.7.18. 


See  Section  2.19.5.7.27. 


See  Section  2.19.5.7.28. 


See  Section  2.19.5.9.9. 


Table  2.19-36  UTMToLongPt  Information. 
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2.19.3.3.6  GetDisTime 

GetDisTime  calculates  the  amount  of  time  it  takes  to  travel  between  two  given  points, 
start _pt  and  end _pt,  at  a  given  speed,  lq)h.  The  function  call  is  GetDisTime(start_c,  end_c, 
kph).  Table  2.19-37  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

start  c 

pointer  to  char 

Standard  C  type. 

end  c 

pointer  to  char 

Standard  C  type. 

kph 

short 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

startjat 

LongPt 

DevelopmentiSIMNET  ilibmac; 
longpt.h 

end_pt 

LongPt 

DevelopmentiSIMNET  :libmac: 
lonQpt.h 

speed 

float 

Standard  C  type. 

dis 

Iona 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

dis 

long 

The  amount  of  time  it  takes  to 
travel  the  given  distance  at  the 
Qiven  speed. 

1  Calls  1 

Function 

Where  Described 

UTMToLonqPt 

See  Section  2.19.3.3.5. 

DistBetween2Pts 

See  Section  2.22.1.23.2. 

Table  2.19-37  GetDisTime  Information. 

2.19.3.4  DoAbout.c 

Development;  SIMNET :  MCC:CE  W  :DoAbout.c 

This  file  contains  routines  for  handling  alerts. 

2.19.3.4.1  SetParamText 

SetParamText  sets  the  text  fields  for  an  alert.  The  parameter,  strNum,  is  the  index  to  a 
.standard  text  siring.  The  function  call  is  SetParamText(strNum).  Table  2.19-38  describes 
the  parameters  us^  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

StrNum 

short 

Standard  C  type 
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Variable 


Internal  Variables 


StringHandle 


Where  TvDedef  Declared 


DevelopmentiTHINK  C: 
Mac  #includes;MacTvpes.h 


Function 


GetStrin 


HLock 


ParamText 


HUnlock 


Calls 


Where  Described 


Standard  Toolbox  Utility  function  for  Macintosh. 


Standard  Memory  Manager  function  for  Macintosh. 


Standard  Dialog  Manager  function  for  Macintosh. 


Standard  Memory  Manager  function  for  Macintosh. 


Function 


DoAbout 


NotlmpDialo 


Called  B 


Where  Described 


See  Section  2.19.3.4.2. 


See  Section  2.19.3.4.3. 


Table  2.19-38  SetParamText  Information. 


2.19.3.4.2  DoAbout 


DoAbout  implements  the  "About..."  selection  in  the  Macintosh  apple  menu.  The  function 
call  is  DoAbout().  Table  2.19-39  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

SetParamText 

See  Section  2.19.3.4.1. 

Alert 

Standard  Dialog  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

MainEventLooD 

See  Section  2.19.2.1.2. 

DoMenu 

See  Section  2.19.2.2.2. 

Table  2.19-39  DoAbout  Information. 


2.19.3.4.3  NotImpDialog 


NotImpDialog  implements  the  "This  function  not  implemented"  dialog.  The  function  call  is 
NotImpDialogO.  Table  2.19-40  describes  the  functions  called  using  diis  function. 


1  Calls  1 

Function 

Where  Described 

SetParamText 

See  Section  2.19.3.4.1. 

Alert 

Standard  Dialog  Manager  function  for  Macintosh. 

1  1 
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1  Called  Bv  1 

Function 

Where  Described 

DoMenu 

See  Section  2.19.2.2.2. 

CheckEmpiacementDialoa 

See  Section  2.19.3.2.5. 

CheckBreachDialoQ 

See  Section  2.19.3.2.7. 

CheckMoveDialoa 

See  Section  2.19.3.2.8. 

CheckStatEmplacementOialo 

a 

See  Section  2.19.3.2.10. 

CheckStatBreachDialoq 

See  Section  2.19.3.2.11. 

CheckStatMoveDialoa 

See  Section  2.19.3.2.12. 

MainHelpButton 

See  Section  2.19.3.5.5. 

HelpStatus 

See  Section  2.19.3.8.6. 

Table  2.19-40  NotImpDialog  Information. 


2.19.3.4.4  Notify 

Notify  fills  in  an  alert  and  notifies  the  user  of  a  problem.  The  alert  is  filled  in  with  the 
string  passed  in  str.  The  function  call  is  Notify(str).  Table  2.19-41  describes  the 
parameters  used  and  functions  called  using  this  function. 
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Function 


main 


Macin'its 


ProcessReauest 


GetTerrainBounds 


isLeaalMinefield 


CheckEmDlacementDialo 


setBreachTime 


CheckBreachDialo 


CheckMoveOialo 


ReviewSelection 


CheckUTMStrin 


CheckDTGStrin 


Iv  area 


Iv  area  loc 


inside 


MissionOb 


MissionObi;;show 


MissionObj;:ResetMission 

Time 


MissionOb 


ServiceObi;:CheckQs 


Called  B 


Where  Described 


See  Section  2.19.2.1.1. 


See  Section  2.19.2.1.3. 


See  Section  2.19.2.1.5. 


See  Section  2.19.2.1.6. 


See  Section  2.19.3.2.2. 


See  Section  2.19.3.2.5. 


See  Section  2.19.3.2.6. 


See  Section  2.19.3.2.7. 


See  Section  2.19.3.2.8. 


See  Section  2.19.3.2.15. 


See  Section  2.19.3.3.1. 


See  Section  2.19.3.3.2. 


See  Section  2.19.4.1.1. 


See  Section  2.19.4.1.2. 


See  Section  2.19.4.1.3. 


See  Section  2.19.5.7.3. 


See  Section  2.19.5.7.4. 


See  Section  2.19.5.7.18. 


See  Section  2.19.5.9.4. 


See  Section  2.19.5.11.4. 


Table  2.19-41  Notify  Information. 

2.19.3.4.5  MySound 

MySound  makes  a  noise  to  alert  the  user,  nwn  is  the  index  of  the  sound  to  make.  The 
function  call  is  MySound(num).  Table  2. 19-42  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

num 

short 

Standard  C  type. 

Calls 

Function 

Where  Described 

SysBeep 

Standard  Operating  System  Utility  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

ServiceObi::CheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-42  MySound  Information. 


2.19.3.5  HotSpots.c 

Development:SIMNET:MCC:CEW:HotSpots.c 

This  file  contains  button  handling  routines.  Table  2.19-43  describes  the  variables  used  by 
HotSpots.c. 
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Variables 

Variable 

Type 

Where  Typedef  Declared 

cewMission 

extern  pointer  to  array  of 
MissionObi 

Development:SIMNET  :CEW: 
MissionObj.h 

nextMission 

extern  short 

Standard  C  type. 

select_dlog 

extern  pointer  to 

OialooWindow 

Development:SIMNET;CEW; 
Dialoa  Windows. h 

main_window 

extern  pointer  to  ComWindow 

Devek)pment:SIMNET  :CEW: 
ComWindows.h 

serviceq 

extern  pointer  to  ServiceObj 

Development;SIMNET:CEW: 

ServiceObj.h 

Table  2.19-43  HotSpots.c  variables  Information. 

2.19.3.5.1  indone 

indone  is  the  prototype  routine  (or  template)  used  to  model  other  button  handling  routines 
in  this  file. 


Parameters 

Parameter 

Where  Typedef  Declared 

cw 

pointer  to  ComWindow 

Development  :SIMNET;CEW: 
ComWindows.h 

X  point 

Point 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

r 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

_ Internal  Variables  _ 

Variable _ Type _ Where  Typedef  Declared 

aevent  EventRecord  Devetopment;THINK  C; 

_ _ Mac  #includes:EventMgr.h 

eventpt  Point  DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 


_ _ Return  Values _ _ 

Return  Value _ Type _ Meaning _ 

TRUE  Short  The  user  has  requested  an 

_ action _ 

F.ALSE  Short  The  user  has  not  requested 

 an  action. 


Calls 

Function 

Where  Described 

RInRect 

Standard  Quickdraw  function  for  Macintosh. 

InvertRect 

Standard  Quickdraw  function  for  Macintosh. 

GetNextEvent 

Standard  Toolbox  Event  Manager  function  for  Macintosh. 

GlobalToLocal 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.19-44  indone  Information. 
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2.19.3.5.2  MissionButton 


MissionButton  is  called  when  the  user  clicks  the  mouse  in  the  New  Mission  button.  The 
new  mission  series  is  brought  up.  The  function  call  is  MissionButton(cw,  r,  xpoint). 
Table  2.19-45  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

cw 

pointer  to  ComWindow 

Development:SIMNET  ;CEW; 
ComWindows.h 

xpoint 

Point 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvpes.h 

r 

Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

r1 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvpes.h 

aevent 

EventRecord 

DevelopmentiTHINK  C; 

Mac  #includes;EventMgr.h 

eventpt 

Point 

Development:THINK  C: 

Mac  #includes;MacTvpes.h 

I  Return  Values  I 

Return  Value 

Meaning 

TRUE 

short 

The  user  requested  the  new 
mission  dialog. 

FALSE 

short 

The  user  did  not  request  the 
new  mission  dialog. 

I  Calls  I 

Function 

Where  Described 

RInRect 

Standard  Quickdraw  function  for  Macintosh. 

InvertRect 

Standard  Quickdraw  function  for  Macintosh. 

GelNextEvent 

Standard  Toolbox  Event  Manager  function  for  Macintosh. 

GlobalToLocal 

Standard  Quickdraw  function  for  Macintosh. 

SelRect 

Standard  Quickdraw  function  for  Macintosh. 

LocalRectToGlobal 

See  Section  2.19.3.10.1. 

ZoomRec* 

See  Section  2.22.1.47.2. 

MissionSelection 

See  Section  2.19.3.5.3. 

Table  2.19-45  MissionButton  Information. 

2.19.3.5.3  MissionSeiection 

MissionSelection  handles  the  user's  selection  of  the  mission  type.  The  choices  of  mission 
types  are  the  Emplacement  Mission,  Breach  Mission,  or  Move  Mission.  The  function  call 
is  Mission  Selection  ().  Table  2.19-46  describes  the  internal  variables  used  and  functions 
called  using  this  function. 
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Variable 


lastButton 


thisMission 


status 


missionType 


Internal  Variables 


e 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  type. 


Standard  C  tvoe. 


Standard  C  type. 


Function 


DialoaWirKjow-activate 


Swindow;:update 


MissionObi;:init 


MissionObi:  iNewMission 


Calls 


Where  Described 


See  Section  2.19.5.5.3. 


See  Section  2.19.5.13.4. 


See  Section  2.19.5.7.1. 


See  Section  2.19.5.7.3. 


Called  B 


Function 

Where  Described 

MissionButton 

See  Section  2.19.3.5.2. 

Table  2.19-46  MissionSelection  Information. 

2.19.3.5.4  StatusButton 

StatusButton  is  called  when  the  user  clicks  the  mouse  in  the  Asset  Status  button.  The  list 
of  assets  and  their  status  is  brought  up.  The  function  call  is  StatusButton(cw,  r,  xpoint). 
Table  2.19-47  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

cw 

pointer  to  ComWindow 

Development;SIMNET  :CEW: 
ComWindows.h 

xpoint 

Point 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

DevelopmentiTHINK  C: 
Mac  #includes:MacTvDes.h 


Variable 


r1 


event  pt 


Internal  variables 


e 


EventRecord 


Where  Typedef  Declared 


DevelopmentTHINK  C; 
Mac  #includes:MacTypes.h 


DevelopmentiTHINK  C: 
Mac  #includes:EventMqr.h 


DevelopmentiTHINK  C: 
Mac  #includes:MacTvDes.h 


Return  Values 


Return  Value 


TRUE 


FALSE 


Type 


short 


Meaning 


The  user  requested  the  Asset 
Status  list. 


The  user  did  not  request  the 
Asset  Status  list. 


654 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Calls  1 

Function 

Where  Described 

RInRect 

Standard  Quickdraw  function  for  Macintosh. 

InvertRect 

Standard  Quickdraw  function  for  Macintosh. 

GetNextEvent 

Standard  Toolbox  Event  Manaqer  function  for  Macintosh. 

GlobalToLocal 

Standard  Quickdraw  function  for  Macintosh. 

DoResourceStatus 

See  Section  2.19.3.8.1. 

Table  2.19-47  StatusButton  Information. 


2.19.3.5.5  MainHeIpButton 

MainHeIpButton  is  called  when  the  user  clicks  the  mouse  in  the  Main  Help  button.  Since 
the  Main  Help  dialog  is  not  implemented,  the  "This  dialog  not  implemented"  dialog  is 
brought  up.  The  function  call  is  MainHelpButton(cw,  r,  xpoint).  Table  2.19-48  describes 
the  parameters  used  and  functions  called  using  this  function. 


I  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

cw 

pointer  to  ComWindow 

DevetopmentiSIMNET  :CEW: 
ComWindows.h 

xpoint 

Point 

Development:THINK  C: 

Mac  #includes:MacTvpes.h 

r 

Rect 

Development:THINK  C: 

Mac  #includes:MacTvpes.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

r1 

Rect 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

aevent 

EventRecord 

Development:THINK  C: 

Mac  #includes:EventMqr.h 

eventpt 

Point 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

1  Return  Values 

Return  Value 

Type 

Meaning 

TRUE 

short 

The  user  requested  the  main 
help  dialog. 

FALSE 

short 

The  user  did  not  request  the 
main  help  dialog. 

1  Calls 

Function 

Where  Described 

RInRect 

Standard  Quickdraw  function  for  Macintosh. 

InvertRect 

Standard  Quickdraw  function  for  Macintosh. 

GetNextEvent 

Standard  Toolbox  Event  Manager  function  for  Macintosh. 

GlobalToLocal 

Standard  Quickdraw  function  for  Macintosh. 

NotImpDialog 

See  Section  2.19.3.4.3. 

Table  2.19-48  MainHeIpButton  Information. 
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2.19.3.6  Refresh. c 

Development:SIMNET :  MCC:CEW  :Refircsh.c 

This  file  contains  a  routine  which  implements  the  initial  window  in  the  CEW  Console. 


Variables 

Variable 

Where  Typedef  Declared 

missionUst 

extern  pointer  to  TextUst 

Development:SIMNET:CEW: 

TextList.h 

mainCTL 

ControlHandle 

DevelopmentTHINK  C: 

Mac  #includes:ControlMor.h 

resCtI 

ControlHandle 

Development:THINK  C: 

Mac  #includes;ControlMor.h 

m_helpCTL 

ControlHandle 

DevelopmentTHINK  C: 

Mac  #includes;ControlMor.h 

Table  2.19-49  Refresh.c  Variable  Information. 

2.19.3.6.1  PrintWindow 

PrintWindow  sets  up  the  initial  window  containing  the  mission  table.  The  mission  table 
text  headings  are  filled  in  and  the  buttons  are  set  up  and  displayed.  The  parameter  window 
specifies  the  window  containing  the  mission  table.  The  function  call  is 
IMntWindow(window).  Table  2. 19-50  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameters 


Parameter 


window 


Variable 


\wm 


pointer  to  ComWindow 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Development:SIMNET  :CEW; 
ComWindows.h 


Where  Tvpedef  Declared 


Development:THINK  C; 
Mac  #includes;MacTypes.h 


Function 


Swindow:;lsVisible 


TextFont 


Text  Size 


MoveTo 


DrawStrin 


SetRect 


NewControl 


Swindow::GetWindowRr 


Com  Wi  ndow : ;  AddHotSoot 


DrawControls 


OutLineRect 


Front  Window 


ReDrawClock 


Calls 


Where  Described 


See  Section  2.19.5.13.6. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Control  Manaoer  function  for  Macintosh. 


See  Section  2.19.5.13.10. 


See  Section  2.19.5.3.2. 


Standard  Control  Manaoer  function  for  Macintosh. 


See  Section  2.19.3.10.5. 


Standard  Window  Manaoer  function  for  Macintosh. 


See  Section  2.22.1.6.3. 


Table  2.19-50  PrintWindow  Information. 
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2.19.3.7  Resitem.c 
Development:SIMNET  :MCC:CEW:ResItem.c 

This  file  implements  the  lists  of  resources  (or  assets)  which  can  be  used  on  missions. 


Variables 


Variable 

Where  Typedef  Declared 

breach_availLjst 

pointer  to  Checklist 

Development:SIMNET;CEW: 
Checklist. h 

move_availList 

pointer  to  Checklist 

Development;SIMNET;CEW: 
Checklist. h 

emplace_availUst 

pointer  to  Checklist 

Development:SIMNET  :CEW: 
Checklist. h 

stat_emplace_availList 

pointer  to  Checklist 

Development:SIMNET:CEW: 
Checklist. h 

stat_breach_avai  List 

pointer  to  Checklist 

Development:SIMNET:CEW: 
Checklist. h 

stat_mo  ve_avai  1  List 

pointer  to  Checklist 

Development  :SIMNET  :CEW; 
Checklist. h 

main_window 

extern  pointer  to  ComWindow 

Development:SIMNET  :CEW: 
ComWindows.h 

empiace_diog 

extern  pointer  to 

DiaiooWindow 

Development  :SIM  NET  :CEW: 
Dialog  Windows. h 

breach_diog 

extern  pointer  to 

DiaiogWindow 

Development:SIMNET:CEW: 
Dialog  Windows. h 

move_diog 

extern  pointer  to 

DiaiogWindow 

Development:SIMNET:CEW: 
Dialog  Windows. h 

stat_empiace 

extern  pointer  to 

DiaiogWindow 

Development:SIMNET:CEW: 
Dialog  Windows. h 

stat_breach 

extern  pointer  to 

DiaiogWindow 

Deveiopment.SIMNET  :CEW: 
Dialog  Windows. h 

stat_move 

extern  pointer  to 

DiaiogWindow 

Development  iSIMNET  :CEW; 
Dialog  Windows. h 

cewResources 

extern  pointer  to  array  of 
ResourceObi 

Development:SIMNET  ;CEW; 
ResourceObi. h 

totaiResources 

extern  short 

Standard  C  tvoe. 

Table  2.19-51  resitem.c  Variable  Information. 

2.19.3.7.1  Resourceltems 

Resourceltems  updates  the  list  of  resources  used  on  the  specified  mission.  Resources  may 
only  be  allocated  to  one  mission.  The  parameter  wp  specifies  which  type  of  mission  dialog 
(emplace,  breach,  move,  etc.),  and  i  is  the  index  to  a  specific  mission  within  the  mission 
list.  The  function  call  is  Resourceltems(wp,  i).  Table  2.19-52  describes  the  parameters 
used  and  functions  called  using  this  function. 


Parameter 


wp 


IDTil 


WindowRr 


Parameters 


Where  Tvoedet  Declared 


Devetopment;THINK  C; 

Mac  #includes:WindowMQr.h 


Standard  C  type. 
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Internal  Variables 


Variable 


tempStr 


Str255 


Where  Tvbedef  Declared 


DevelopmentTHINK  C; 
Mac  #jncludes;MacTypes.h 


Standard  C  type. 


Function 


DialoQWindow;:egual 


DialoaWindow-GetItemRect 


Check  List::init 


ResourceObj-GetName 


CheckList;:AddRow 


TextList;;ListUDdate 


CheckList;;GetState 


Calls 


Where  Described 


See  Section  2.19.5.5.15. 


See  Section  2.19.5.5.14. 


See  Section  2.19.5.1.1. 


See  Section  2.19.5.9.10 


See  Section  2.19.5.1.2. 


See  Section  2.19.5.15.2. 


See  Section  2.19.5.1.6. 


Table  2.19-52  Resourceltems  Information. 

2.19.3.7.2  CheckList_Handler 

CheckList_Handler  handles  events  in  the  list  of  Resources  (or  assets).  When  the  mouse  is 
clicked  on  a  resource,  the  resource  state  is  toggled  to  either  selected  or  not  selected.  The 
parameter  availList  points  to  the  available  resources  list.  theEvent  points  to  the  resource 
row  in  the  list,  state  is  the  state  of  that  resource.  The  function  call  is 
CheckList_Handler(availList,  theEvent,  state).  Table  2.19-53  describes  the  parameters 
used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

availList 

pointer  to  CheckList 

Development:SIMNET;CEW; 
CheckList. h 

theEvent 

pointer  to  EventRecord 

DevelopmentTHiNK  C: 

Mac  #includes:EventMar.h 

state 

short 

Standard  C  type. 

Variable 


eventpt 


where 


Internal  Variables 


e 


Point 


Where  Typedef  Declared 


DevelopmentTHINK  C: 
Mac  #includes:MacTvDes.h 


Standard  C  type. 


Calls 

Function 

Where  Described 

GlobalToLocal 

Standard  Quickdraw  function  for  Macintosh. 

TextList;;List1  Click 

See  Section  2.19.5.15.12. 

CheckList::ToggleState 

See  Section  2.19.5.1.7. 
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1  Called  By  1 

Function 

Where  Described 

CheckEmolacementDialoa 

See  Section  2.19.3.2.5. 

CheckBreachDialoa 

See  Section  2.19.3.2.7. 

CheckMoveDialoa 

See  Section  2.19.3.2.8. 

CheckStatEmplacementOialo 

a 

See  Section  2.19.3.2.10. 

CheckStatBreachDialog 

See  Section  2.19.3.2.11. 

CheckStatMoveDialoq 

See  Section  2.19.3.2.12. 

Table  2.19-53  CheckList_Handler  Information. 

2.19.3.7.3  DeleteResourceLists 

DeleteResourceLists  deletes  all  available  resource  lists.  The  function  call  is 
DeleteResourceLists().  Table  2.19-54  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

TextList;;ListDispose 

See  Section  2.19.5.15.3. 

DialogWindow;;quit 

See  Section  2.19.5.5.4. 

Table  2.19-54  DeleteResourceLists  Information. 

2.19.3.8  ResStatusWindow.c 

Development;  S IMNET  ;MCC:CEW:  ResStatusWindow.c 

ResStatusWindow.c  implements  the  available  resource  status  list  dialog  windows. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

resource_window 

pointer  to  ComWindow 

Development;SIMNET  :CEW: 
ComWindows.h 

resList 

pointer  to  TextList 

Development:SIMNET;CEW: 
TextList. h 

exitClL 

ControlHandle 

DevelopmentiTHINK  C: 

Mac  #includes;ControlMqr.h 

heIpCTL 

ControiHandle 

DeveiopmentiTHINK  C: 

Mac  #includes:ControlMqr.h 

main_window 

extern  pointer  to  ComWindow 

DevelopmentiSIMNET  :CEW: 
ComWindows.h 

cewResources 

extern  pointer  to  array  of 
ResourceObi 

DevelopmentiSIMNET  :CEW: 
ResourceObi. h 

totalResources 

extern  short 

Standard  C  type. 

Table  2.19-55  ResStatusWindow.c  Variable  Information. 
2.19.3.8.1  DoResuurceSiaiua 

DoResourceStatus  implements  the  Resource  Status  window.  When  the  user  clicks  the 
mouse  on  the  Asset  Status  button  the  Rsource  Status  window  appears  with  a  list  of 
Resources  (or  Assets)  with  their  current  locations  and  states.  The  function  call  is 
DoResourceStatus().  Table  2.19-56  describes  the  functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

SetupResWindow 

See  Section  2.19.3.8.2. 

OtherEventLoop 

See  Section  2.19.3.8.7. 

ResCleanUp 

See  Section  2.19.3.8.8. 

Called  By 

Function 

Where  Described 

MainEventLoop 

See  Section  2.19.2.1.2. 

StatusButton 

See  Section  2.19.3.5.4. 

Table  2.19-56  DoResourceStatus  Information. 
2.19.3.8.2  SetupResWindow 


SetupResWindow  sets  up  the  window  of  lists  of  Resources  (or  Assets).  The  function  call 
is  SetupResWindow().  Table  2.19-57  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

r 

Rect 

DevelopmentTHINK  C: 

Mac  #inclurtes:MacTvoes.h 

tempStr 

Str255 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

i 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ComWindow;;initial 

See  Section  2.19.5.3.3. 

ComWindow::show 

See  Section  2.19.5.3.1. 

SetRect 

Standard  Quickdraw  function  for  Macintosh. 

NewControl 

Standard  Control  Manaaer  function  for  Macintosh. 

Swindow::GetWindowRr 

See  Section  2.19.5.13.10. 

ComWindow;;AddHotSpot 

See  Section  2.19.5.3.2. 

OutLineRect 

See  Section  2.19.3.10.5. 

TextList;;init 

See  Section  2.19.5.15.1. 

HeadinqSetUp 

See  Section  2.19.3.8.4. 

ResourceObi::show 

See  Section  2.19.5.9.13. 

Resou  rceObi :  iGelStatus 

See  Section  2.19.5.9.12. 

ResourceObi::GetMission 

See  Section  2.19.5.9.5. 

TextList:;AddRow 

See  Section  2.19.5.15.6. 

1  Called  By  1 

Function 

Where  Described 

DoResourceStatus 

See  Section  2.19.3.8.1. 

Table  2.19-57  SetupResWindow  Information. 
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2.19.3.8.3  RefreshWindow 

RefreshWindow  refreshes  the  screen  specified  by  the  parameter  window.  The  function  call 
is  Refresh Window(window).  Table  2.19-58  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

window 

pointer  to  ComWindow 

Development:SIMNET  :CEW; 
ComWindows.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

r 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes;MacTvpes.h 

Calls 

Function 

Where  Described 

Swindow;;ls  Visible 

See  Section  2.19.5.13.6. 

HeadinqSetUo 

See  Section  2.19.3.8.4. 

TextList::ListUDdate 

See  Section  2.19.5.15.2. 

DrawControls 

Standard  Control  Manaoer  function  for  Macintosh. 

Swi  ndow :  ;Get  Wi  ndowRr 

See  Section  2.19.5.13.10. 

OutLineRect 

See  Section  2.19.3.10.5. 

Table  2.19-58  RefreshWindow  Information. 

2.19.3.8.4  HeadingSetUp 

HeadingSetUp  lists  the  heading  tides  in  the  window.  The  function  call  is  HeadingSetUpO. 
Table  2.19-59  describes  the  functions  called  using  this  function. 


I  Calls  I 

Function 

Where  Described 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

TextSize 

Standard  Quickdraw  function  for  Macintosh. 

MoveTo 

Standard  Quickdraw  function  for  Macintosh. 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

SetupResWindow 

See  Section  2.19.3.8.2. 

RefreshWindow 

See  Section  2.19.3.8.3. 

Table  2.19-59  HeadingSetUp  Information. 
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2.19.3.8.5  DoneStatus 

DoneStatus  puts  up  the  mission  window  when  the  user  is  done  with  the  Resource  Status 
window,  cw  points  to  the  Resource  Status  Window;  xpoint  is  the  location  of  the  mouse 
click;  r  is  oudine  of  the  Done  button.  The  function  call  is  DoneStatus(cw,  r,  xpoint).  Table 
2.19-60  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

cw 

pointer  to  ComWindow 

Development:SIMNET  ;CEW: 
ComWindows.h 

xpoint 

Point 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

r 

Rect 

Developmenf.THINK  C; 

Mac  #includes;MacTvpes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

eventpt 

Point 

DevelopmentiTHINK  C: 

Mac  #includes;MacTvpes.h 

X 

short 

Standard  C  tvpe. 

Return  Values 

Return  Value 

Type 

Meaning 

TRUE 

short 

The  user  clicked  on  the  Done 
button;  the  Resource  Status 
window  is  put  away  and  the 
Mission  window  is  brought 
back. 

FALSE 

short 

The  user  did  not  click  on  the 
Done  button. 

Calls 

Function 

Where  Described 

RlnRecl 

Standard  Quickdraw  function  for  Macintosh. 

TrackControl 

Standard  Control  Manager  function  for  Macintosh. 

T  exlLisl :  rLislDispose 

See  Section  2.19.5.15.3. 

KillControls 

Standard  Control  Manaqer  function  for  Macintosh. 

Swindow::GetWindowRr 

See  Section  2.19.5.13.10. 

Swindow::quit 

See  Section  2.19.5.13.3. 

Table  2.19-60  DoneStatus  Information. 

2.19.3.8.6  HelpStatus 

HelpStatus  puts  up  the  Help  window  when  the  user  clicks  on  the  Help  button.  Note  that 
the  Help  window  is  not  implemented,  cw  points  to  the  current  window;  xpoint  is  the 
location  of  the  mouse  click;  r  is  the  rectangle  outlining  the  Help  button.  TTie  function  call 
is  HelpStatus(cw,  r,  xpoint).  Table  2.19-61  describes  the  parameters  used  and  functions 
called  using  this  function. 
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1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

cw 

pointer  to  ComWindow 

Development:SIMNET  :CEW; 
ComWindows.h 

xpoint 

Point 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

r 

Rect 

Development:THINK  C: 

Mac  ffincludesiMacTvpes.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

eventpt 

Point 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

X 

short 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

short 

The  user  clicked  on  the  Help 
button. 

FALSE 

short 

The  user  did  not  click  on  the 
Help  button. 

1  Calls  1 

Function 

Where  Described 

PtInRect 

Standard  Quickdraw  function  for  Macintosh. 

TrackControl 

Standard  Control  Manaaer  function  for  Macintosh. 

NotlmpDialod 

See  Section  2.19.3.4.3. 

Table  2.19-61  HelpStatus  Information. 


2.19.3.8.7  OtherEventLoop 

OtherEventLoop  handles  events  when  the  Resource  Status  window  is  frontmost.  The 
function  call  is  OtherEventLoopO.  Table  2.19-62  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

myEvent 

EventRecord 

DevelopmentTHINK  C: 

Mac  #includes;EventMar.h 

eventpt 

Point 

DevelopmentTHINK  C: 

Mac  #includes:MacTvoes.h 

astr 

Str255 

DevelopmentTHINK  C: 

Mac  #includes;MacTvpes.h 

c 

char 

Standard  C  type. 

j _ short _ Standard  C  type. _ 

status _ short _ Standard  C  type. _ 

wwindow  WindowRr  DevelopmentiTHINK  C: 

_ Mac  #includes:WindowMgr.h 

windowcode _ short _ Standard  C  type. _ 
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1  !  Calls  1 

Function 

Where  Described 

SvstemTask 

Standard  Desk  Manaqer  function  for  Macintosh. 

GetNextEvent 

Standard  Toolbox  Event  Manaqer  function  for  Macintosh. 

T  extList :  iListDispose 

See  Section  2.19.5.15.3. 

KillControls 

Standard  Control  Manaqer  function  for  Macintosh. 

Swindow::GetWindowRr 

See  Section  2.19.5.13.10. 

Swindow-quit 

See  Section  2.19.5.13.3. 

Swindow  "update 

See  Section  2.19.5.13.4. 

Find  Window 

Standard  Window  Manaqer  function  for  Macintosh. 

Swindow;:equal 

See  Section  2.19.5.13.8. 

Hi  lit  e  Window 

Standard  Window  Manaqer  function  for  Macintosh. 

SelectWindow 

Standard  Window  Manaqer  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

GlobalToLocal 

Standard  Quickdraw  function  for  Macintosh. 

ComWi  ndow :  :CbeckHotSoot 

See  Section  2.19.5.3.4. 

Front  Window 

Standard  Window  Manaqer  function  for  Macintosh. 

TextList::List1  Click 

See  Section  2.19.5.15.12. 

NetworkEventHandler 

See  Section  2.22.1.3.5. 

Called  Bv 

Function 

Where  Described 

DoResourceStatus 

See  Section  2.19.3.8.1. 

Table  2.19-62  OtherEventLoop  Information. 

2.19.3.8.8  ResCleanUp 

ResCleanUp  cleans  up  any  allocated  memory  when  a  resource  list  is  deleted.  The  function 
call  is  ResCleanUpO.  Table  2.19-63  describes  the  functions  which  call  this  function. 


1  Called  Bv  1 

Function 

Where  Described 

DoResourceStatus 

See  Section  2.19.3.8.1. 

Table  2.19-63  ResCleanUp  Information. 


2.19.3.9  StatusSupport.c 

Development:SIMNET:MCC:CEW:StatusSupport.c 

This  file  contains  routines  used  to  support  the  Resource  and  Mission  Status  Windows. 


1  Variables  I 

Variable 

Where  Typedef  Declared 

mission  fields 

array  of  lonq 

Standard  C  type. 

resource  fields 

array  of  lonq 

Standard  C  type. 

Table  2.19-64  StatusSupport.c  Variable  Information. 
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2.19.3.9.1  AssembleMissionString 

AssembleMissionString  sets  up  fields  in  the  Mission  Table  rows  so  that  the  columns  line 
up  properly,  num  is  the  mission  number  field;  type  is  the  mission  type  field;  where  is  the 
mission  location;  timel  is  the  mission  start  field;  time2  is  the  mission  finish  field;  status  is 
the  mission  status  field;  order  type  is  the  mission  order  Tvt\&,fimlstr  is  the  mission  end 
field.  The  function  call  is  AssembleMissionString(num,  type,  where,  timel,  time2,  status, 
order_type,  finalstr).  Table  2.19-65  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

num 

short 

Standard  C  type. 

type 

Rr 

Development;THINK  C: 

Mac  #includes:MacTvpes.h 

where 

Rr 

Development:THINK  C: 

Mac  #includes:MacTvpes.h 

timel 

Rr 

Development:THINK  C: 

Mac  #includes;MacTvpes.h 

time2 

Rr 

Development;TH!NK  C: 

Mac  #includes;MacTvpes.h 

status 

Rr 

Development:THINK  C; 

Mac  #includes;MacTypes.h 

order_type 

Rr 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

finalstr 

Str255 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

tempStr 

Str255 

DevelopmentiTHINK  C: 

Mac  #includes;MacTypes.h 

Standard  C  type. 


Function 


NumToString 


Calls 


Where  Described 


Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 


See  Section  2.19.3.9.6. 


Called  B 


Function 

Where  Described 

MissionObj;:edit 

See  Section  2.19.5.7.2. 

MissionObi;:NewMission 

See  Section  2.19.5.7.3. 

MissionObi::show 

See  Section  2.19.5.7.4. 

MissionObj;:UpdateMissionStr 

inq 

See  Section  2.19.5.7.5. 

Table  2.19-65  AssembleMissionString  Information. 
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2.19.3.9.2  AssembleResourceS tring 

AssembleResourceString  sets  up  fields  in  the  Resource  Table  rows  so  that  the  columns  line 
up  properly,  a  is  the  resource  vehicle  number  field;  b  is  the  resource  location;  c  is  the 
resource  speed  field;  d  is  the  resource  status  i\t\d\finalstr  is  the  resource  end  field.  The 
function  call  is  AssembleResourceString(a,  b,  c,  d,  finalstr).  Table  2.19-66  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

a 

Rr 

DevetopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

b 

Rr 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

c 

Rr 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

d 

Rr 

DevelopmentTHINK  C; 

Mac  #includes;MacTvpes.h 

finalstr 

Str255 

DevelopmentTHINK  C; 

Mac  #includes:MacTvpes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

tempStr 

Str255 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

i 

Short 

Standard  C  type. 

Calls 

FuncHon  1  Where  Described 

stccpy  1  See  Section  2.19  3.9.6. 

Called  By 

Function 

Where  Described  «. 

ResourceObj;;show 

See  Section  2.19.5.9.13. 

Table  2.19-66  AssembleResourceString  Information. 
2.19.3.9.3  ReplaceMissionField 


RepIaceMissionField  replaces  the  field  specified  by  num  in  the  Mission  Table  with  the  text 
specified  in  text.  The  function  cai' ...  ReplaceMissionField(num,  text,  finalstr).  Table 
2.19-67  de.scribes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

num 

short 

Standard  C  type 

text 

Rr 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes  h 

finalstr 

Str255 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes  h 

r  ^ 
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1  Calls  1 

Function 

Where  Described 

ClearField 

See  Section  2.19.3.9.5. 

stccpy 

See  Section  2.19.3.9.6 

I  Called  By 

FuncJon 

Where  Described 

MissionObi;;SetStatus 

See  Section  2.19.5.7.20. 

MissionObj::SendEmplaceme 

nt 

See  Section  2.19.5.7.27. 

MissionObjiiSendBreach 

See  Section  2.19.5.7.28. 

Table  2.19-67  ReplaceMissionField  Information. 


2.19.3.9.4  MarkField 


MarkField  places  a  period  at  the  end  of  the  field  specified  by  num.  The  function  call  is 
MarkField(num,  finalstr).  Table  2.19-68  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

num 

short 

Standard  C  type. 

finalstr 

Str255 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

tempStr 

Str255 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

1  Calls  1 

Function 

Where  Described 

stccpy 

See  Section  2.19.3.9.6. 

Table  2.19-68  MarkField  Information. 


2.19.3.9.5  ClearField 


ClearField  is  used  to  clear  a  field.  The  field  specified  by  num  is  filled  with  blanks.  The 
function  call  is  ClearField(num,  finalstr).  Table  2.19-69  describes  the  parameters  used  by 
this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

num 

short 

Standard  C  type. 

finalstr 

Str255 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 
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Called  B 


Function 

Where  Described 

ReplaceMissionField 

See  Section  2.19.3.9.3. 

Table  2.19-69  ClearField  Information. 

2.19.3.9.6  stccpy 

stccpy  copies  the  C  string  pointed  to  by  p  into  another  C  string  pointed  to  by  c.  num  is  the 
number  of  characters  in  the  string.  The  The  function  call  is  stccpy(s,  p,  num).  Table  2.19- 
70  describes  the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard  C  type. 

D 

pointer  to  char 

Standard  C  type. 

num 

short 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

1  Called  By  I 

Function 

Where  Described 

AssembleMissionStrinq 

See  Section  2.19.3.9.1. 

AssembleResourceStrino 

See  Section  2.19.3.9,2. 

ReplaceMissionField 

See  Section  2.19.3.9.3. 

MarkField 

See  Section  2.19.3.9.4. 

Table  2,19-70  stccpy  Information. 


2.19.3.10  Utils.c 

Development:SIMNET:MCC:CEW:Utils.c 

This  file  contains  utility  routines  used  by  the  CEW  Workstation. 

2.19.3.10.1  LocalRectToGlobal 


LocalRectToGlobal  changes  the  coordinates  of  the  rectangle  area  from  local  to  global 
coordinates.  The  function  call  is  Lx3calRectToGlobal(aRect).  Table  2.19-71  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

arect 

pointer  to  Rect 

Development  THINK  C: 

Mac  #includes;MacTypes.h 

Calls 

Function 

Where  Described 

LocalToGlobal 

Standard  Quickdraw  function  for  Macintosh, 

[  1 
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1  Called  By  1 

Function 

Where  Described 

MissionButton 

See  Section  2.19.3.5.2. 

Table  2.19-71  LocalRectToGlobal  Information. 

2.19.3.10.2  stxcpy 

stxqjy  copies  the  C  string  pointed  to  by  p  into  another  C  string  pointed  to  by  c.  num  is  the 
number  of  characters  in  the  string.  The  function  call  is  stxcpy(s,  p,  num).  Table  2. 19-72 
describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard  C  type. 

D 

DOinter  to  char 

Standard  C  type. 

num 

short 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

1  Called  By  1 

Function 

Where  Described 

Checklist:  :Add  Row 

See  Section  2.19.5.1.2. 

CheckList::SetRow 

See  Section  2.19.5.1.3. 

CheckList.'.GetRow 

See  Section  2.19.5.1.4. 

Table  2.19-72  stxcpy  Information. 


2.19.3.10.3  stpcpy 

stpcpy  converts  the  Pascal  string  pointed  to  by  p  into  a  C  string  pointed  to  by  c.  The 
function  call  is  stpcpy().  Table  2.19-73  descrites  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard  C  type 

£ _ 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

1  Called  By  1 

■  Function 

Where  Described 

See  Section  2.19.3.3.1. 

1  ResourceObi::init 

See  Section  2.19.5.9.1. 

See  Section  2.19.5.9.10. 

Table  2.19-73 


stpcpy  Information. 


669 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.19.3.10.4  HiliteRect 

HiliteRect  causes  a  button  represented  by  the  rectangle  r  to  change  its  appearance  when 
clicked  on  by  the  user.  The  function  call  is  HiliteRect(r).  Table  2.19-74  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


IB7!I 


pointer  to  Rect 


Where  Typedef  Declared 


DevelopmentTHINK  C; 
Mac  #includes:MacTvpes.h 


Variable 


hitPattern 


Internal  Variables 


e 


Pattern 


ibt: 


Where  Tvoedef  Declared 


Devetopment:THINK  C; 
Mac  #includes:Quickdraw.h 


Function 


PenMode 


PenPat 


PaintRect 


PenNormal 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  lor  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Table  2.19*74  HiliteRect  Information. 


2.19.3.10.5  OutLineRect 

OutLineRect  causes  a  button  represented  by  the  rectangle  r  to  become  outlined.  Generally, 
this  routine  is  used  to  outline  the  OK  button.  The  function  call  is  OutLineRect(r).  Table 
2.19-75  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


pointer  to  Rect 


Where  Tvoedef  Declared 


Development:THINK  C; 
Mac  #includes:MacTvDes.h 


Function 


InsetRect 


PenNormal 


PenSize 


FrameRoundRect 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Function 


PrintWindow 


SetuoResWindow 


RefreshWindow 


Called  B 


Where  Described 


See  Section  2.19.3.6.1. 


See  Section  2.19.3.8.2. 


See  Section  2  19.3.8.3. 


Table  2.19-75  OutLineRect  Information. 
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2.19.3.10.6  GetCurrentMonth 

GetCurrentMonth  fills  in  the  parameter  astr  with  the  current  month  in  a  text  string  format. 
The  function  call  is  GetCurrentMonth(astr).  fable  2.19-76  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

astr 

register  pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

now 

unsigned  long 

Standard  C  type. 

dtg 

DateTimeGroup 

Development:SIMNET  :libmac; 
dtg.h 

str 

array  of  20  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

DTGEIapsed 

See  Section  2.22.1.15.3. 

DTGToStrinq 

See  Section  2.22.1.15.1. 

1  Called  Bv  1 

Function 

Where  Described 

CEStringToDTG 

See  Section  2.19.3.10.7. 

Table  2.19-76  GetCurrentMonth  Information. 


2.19.3.10.7  CEStringToDTG 

CEStringToDTG  converts  a  Combat  Engineering  Workstation  date/time  string  to  a  DTG 
format,  cp  points  to  the  CEW  date/tim**  string;  is  filled  in  with  the  CEW  date  in  Date 
Time  Group  format.  The  function  call  is  CEStringToDTG(cp,  dtg).  Table  2.19-77 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


Parameters 


e 


register  pointer  to  char 


pointer  to  DatelimeGroup 


Where  Tvpedef  Declared 


Standard  C  type. 


Development:SIMNET  ;libmac: 
dtg.h 


variable 


tempStr 


Internal  Variables 


e 


array  of  100  char 


Where  Tvpedef  Declared 


Standard  C  type. 


Return  Value _ 

StringToDTG(tempStr,  dtg) 


Type 

short 


Return  Values 


Meaning _ 

The  CEW  date  converted  to 
DTG  
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1  Calls  1 

Function 

Where  Described 

GetCurrentMonth 

See  Section  2.19.3.10.6. 

StrinaToDTG 

See  Section  2.22.1.15.2. 

Table  2.19-77  CEDStringToDTG  Information. 


2.19.3.10.8  CEDTGToString 

CEDTGToString  converts  a  Combat  Engineering  Workstation  date/time  in  DTG  format  to  a 
string,  dtg  points  to  the  CEW  date  in  Date  Time  Group  format;  cp  is  filled  in  with  the  CEW 
date/time  string.  The  function  call  is  CEDTGToString(dtg,  str).  Table  2.19-78  describes 
the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

dtg 

register  pointer  to 
DateTlmeGrouo 

Development:SIMNET  :libmac: 
dtq.h 

str 

register  pointer  to  char 

Standard  C  type. 

1  Called  By  I 

Function 

Where  Described 

MissionObj:;edit 

See  Section  2.19.5.7.2. 

MissionObi;:NewMission 

See  Section  2.19  5.7.3. 

MissionObi;;show 

See  Section  2.19.5.7.4. 

MissionObj:;UpdateMissionStr 

inq 

See  Section  2.19  5.7.5. 

Table  2.19-78  CEDTGToString  Information. 


2.19.4  Minefield  Geometry 


2.19.4.1  polyarea.c 

Development:SIMNET:MCC:CEW:poly_area.c 

This  file  contains  routines  used  to  calculate  the  area  of  a  user  created  minefield,  given  the 
coordinates  of  the  polygon's  vertices. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

errString 

Str255 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvpes.h 

Table  2.19-79  poly_area.c  Variable  Information. 

2.19.4.1.1  poly_area 

poly_area  computes  the  area  of  a  polygon.  This  routine  sets  up  a  data  structure  called 
new_\erts,  then  calls  the  routine  poly_area_loc()  to  perform  the  area  calculation. 
num  verts  is  the  number  of  venices;  verts  is  the  array  of  vertices  (x,y)  coordinates;  areap 
is  filled  in  with  the  area  by  poly_area_loc().  It  is  assumed  that  the  distinct  vertices  are  listed 
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without  repeating  the  first  one  at  the  end  (vem[0]  to  verts[num_yerts  - 1],  with  the  last 
vertex  not  equal  to  the  first).  It  is  also  assumed  that  the  polygon  has  no  self- 
shortersections.  Note  that  this  routine  does  not  work  well  if  the  polygon  has  vertices  in  a 
row.  The  function  call  is  poly_area(verts,  num_verts,  areap).  Table  2.19-80  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

verts 

pointer  to  LongR 

Development:SIMNET  ;libmac: 
lonqpt.h 

num  verts 

short 

Standard  C  type. 

areap 

pointer  to  double 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

code 

short 

Standard  C  type. 

i 

reqister  short 

Standard  C  type. 

new_verts 

pointer  to  LongR 

Development:SIMNET  ilibmac; 
lonqpt.h 

1  Return  Values  1 

Return  Value 

Meaning 

1 

short 

unsuccessful 

code 

short 

If  equal  to  0,  then  successful; 

If  equal  to  1 ,  then 
unsuccessful. 

I  Calls  I 

Function 

Where  Described 

NewRr 

Standard  Memory  Manaaer  function  for  Macintosh. 

Notify 

See  Section  2.19.3.4.4. 

poly  area  loc 

See  Section  2.19.4.1.2. 

I  Called  By  I 

Function 

Where  Described 

DetermineMines 

See  Section  2.19.3.2.14. 

Table  2.19-80  poly_area  Information. 

2.19.4.1.2  poly_area_loc 

poly_area_loc  calculates  the  area  of  the  polygon,  where  verts  is  the  array  of  vertices  (x,y) 
coordinates  and  num_yerts  is  the  number  of  vertices,  areap  is  filled  in  with  the  area  of  ^e 
polygon.  The  routine  first  checks  that  the  parameters  define  an  actual  polygon.  If  the 
polygon  is  a  triangle  (num  verts  =  3),  its  area  is  calculated  and  filled  into  areap. 

If  the  polygon  is  made  up  of  more  than  three  vertices,  the  routine  calculates  its  area  as 
follows:  A  triangle  is  created  from  the  first  three  vertices:  verts[vert  -1],  verts[vert\,  and 
vens[vert  +1].  no  other  vertex  of  the  polygon  is  within  this  triangle  and  the  triangle  is 
located  on  the  inside  of  the  polygon,  the  triangle  is  removed  from  the  polygon,  and  the  area 
of  the  triangle  is  added  to  areap.  The  vertex  verts{vert\  is  removed  from  the  original 
polygon,  leaving  a  new,  smaller  polygon.  The  area  of  this  polygon  is  reduced  by 
recursively  calling  poly_area_loc().  If  the  reduction  is  successful,  the  routine  returns  0  and 
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areap  contains  the  area  of  the  original  polygon.  If  the  reduction  is  unsuccessful,  1  is 
returned. 

The  function  call  is  poly_area_loc(verts,  num_verts,  areap).  Table  2.19-81  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


verts 


num  verts 


vert  inside 


X  max 


max 


inpt 


outpt 


triangle 


area  incr 


Parameters 


e 


pointer  to  LongR 


short 


inter  to  double 


Where  Tvpedef  Declared 


De  velopment  ;SI  M  N  ET  :libmac ; 
lonoDt.h 


Standard  C  t 


Standard  C  type. 


Internal  Variables 

Variable 

Where  Typedef  Declared 

vert 

1  reoister  short  1 

Standard  C  type. 

reaister  short 


short 


LongPt 


LongPt 


array  of  LongR 


double 


Standard  C  type. 


Standard  C  tyoe. 


Standard  C  type. 


Standard  C  type. 


DevelopmentiSIMNET  :libmac: 
lonopt.h 


Development:SIMNET  :libmac: 
lonopt.h 


Development:SIMNET  :libmac: 
lonopt.h 


Standard  C  type. 


Return  Value 


poly_area_loc(  verts. 
num_verts  -1 ,  areap) 


Return  Values 


e 


short 


short 


Meaning 


Unsuccessful 


Successful 


If  equal  to  0,  the  reduction  was 
successful; 

If  equal  to  1 ,  the  reduction  was 
unsuccessful. 


Function 


AREA  TRIANGLE 


inside  pol 


ly  area  loc 


rs 


Calls 


Where  Described 


Macro  defined  in  Development:SIMNET:CEW:poly  area.h. 


See  Section  2.19.3.4.4. 


See  Section  2.19.4.1.3. 


See  Section  2.19.4.1.2. 


Function 


ly  area  loc 


ly  area 


rs 

13 


Called  B 


Where  Described 


See  Section  2.19.4.1.2. 


See  Section  2.19.4.1.1. 


Table  2.19-81  poly_area_loc  Information. 
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2.19.4.1.3  inside_poly 

inside_poly  determines  whether  a  point  lies  inside  or  outside  a  polygon,  inptp  is  the  point 
being  test^;  outpt  is  a  point  known  to  be  outside  the  polygon.  The  polygon  is  form^  by 
the  array  of  vertices  coordinates  verts,  with  the  number  of  vertices  equil  to  num  verts. 

The  function  call  is  inside_poly(inptp,  outptp,  verts,  num_verts).  Table  2.19-82  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

inptp 

pointer  to  LongPt 

Development:SIMNET  :libmac: 
lonqpt.h 

outptp 

pointer  to  LongR 

Development:SIMNET  tlibmac: 
lonqpt.h 

verts 

pointer  to  LongR 

DevelopmentiSIMNET  :libmac; 
lonqpt.h 

num  verts 

short 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

params 

segintparams 

Development:SIMNET  ;CEW: 
seq  intrsct. h 

code  cnt 

array  of  NUM  CODES  short 

Standard  C  type. 

X  max 

lonq 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

params.code  num  arr[MID  C 
ROSS]  &  1 

short 

The  number  of  MID_CROSS 
intersections  found: 

If  greater  than  0,  the  point  lies 
inside  the  polygon. 

If  equals  0,  the  point  lies 
outside  the  polygon. 

Oalls 

Function 

Where  Described 

sea  intrsct 

See  Section  2.19.4.3.1. 

Notify 

See  Section  2.19.3.4.4. 

Called  By 

Function 

Where  Described 

poly  area  loc 

See  Section  2.19.4.1.2. 

Table  2.19-82  inside_poly  Information. 


2.19.4.2  poly_area.h 

Development:SIMNET;MCC:CEW:poly_area.h 

This  file  contains  definitions  used  within  the  file  poly_area.c.  AREA_TRIANGLE  is 
defined  to  compute  the  area  of  a  triangle.  MAX_NUM_VERTS  is  defined  as  the  maximum 
number  of  vertices  in  a  polygon  whose  area  is  calculated  by  poly_area(). 
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2.19.4.3  seg_intrsct.c 

Development:SIMNET:MCC:CEW:seg_intrsct.c 

This  file  contains  a  routine  used  to  determine  whether  a  line  segment  crosses  or 
inappropriately  touches  (i.e.  in  the  middle)  any  of  an  array  of  previous  line  segments.  The 
routine  works  with  points  whose  coordinates  are  long. 

2.19.4.3.1  seg_intrsct 

seg_intrsct  computes  information  on  the  intersection  of  a  line  segment  with  an  array  of 
connected  line  segments.  The  parameter  paramsp  is  a  segintparams  structure  formed  of  the 
members  describe  in  Section  2.19.4.4.  paramsp->ptOp  to paramsp->ptlp  with  the 
connected  line  segments  array  paramsp->pt_arr[i\  to paramsp->pt_arr[i  +  /],  where  i  is 
equal  to  0  to parantsp->num jjt  arr  -  2.  (i.e.  the  connected  points  from paramsp->pt_arr[0] 
Xoparamsp->pt_arr[num  j)t_arr-i].  The  number  of  points,  jjt  or r,  must 

be  greater  than  or  equal  to  2.  For  ccmiputing  points  of  intersection, 
paramsp->size_out _ptsp  should  be  at  least  2,  in  case  of  segment  overlap.  The  function  call 
is  seg_intrsct(paramsp).  Table  2.19-83  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

paramsp 

pointer  to  segin4)arams 

Development  :SIM  NET  :CEW; 
seg  intrsct.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

use  X 

register  short 

Standard  C  type. 

X  diff 

register  short 

Standard  C  type. 

V  diff 

register  short 

Standard  C  type. 

i 

register  short 

Standard  C  type. 

slope 

register  double 

Standard  C  type. 

code 

register  short 

Standard  C  type. 

abort  code 

register  short 

Standard  C  type. 

num  code 

register  short 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

DUMMY 

short 

Unsuccessful 

code 

short 

An  intersection  code. 

See  return  values  of 

check_xjnts  and 

check  y  ints  for  descriptions. 

1  Calls  1 

Function 

Where  Described 

check  X  infs 

See  Section  2.19.4.3.2. 

print  int  code 

See  Section  2.19.4.3.5. 

check  Y  infs 

See  Section  2.19.4.3.3. 

1  1 

BBN  Systems  and  Technologies 


MCC  CSCI 


1  Called  Bv  1 

Function 

Where  Described 

isLeaalMinefield 

See  Section  2.19.3.2.2. 

inside  poly 

See  Section  2.19.4.1.3. 

Table  2.19-83  seg_intrsct  Information. 


2.19.4.3.2  check_x_ints 

check_x_ints  checks  for  an  intersection  of  finite  line  segments.  The  two  segments  are 
defined  by  the  input  coordinates  ptOp  to  ptlp  and  pt2p  to  pt3p.  The  slope  of  the  ptOp  to 
ptlp  segment  is  slope  (dy/dx),  and  is  assumed  to  be  between  -i  and  1.  A  description  code 
of  Ae  type  of  intersection  between  the  segments  is  returned,  outcode  contains  the  list  of 
the  intersection  codes  for  which  all  intersection  points  are  to  be  reported;  outp  and  outp2  are 
arrays  of  intersection  points,  coded  by  the  type  of  intersection  of  the  given  point;  numoutp 
is  the  number  of  coded_lpoints  that  are  valid  intersection  points.  The  function  call  is 
check_x_jnts(ptOp,  ptlp,  slope,  pt2p,  pt3p,  outcode,  outp,  outp2,  numoutp).  Table  2.19- 
84  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

ptOp 

pointer  to  Long_Point 

Development:SIMNET  :CEW; 
seg  intrsct.h 

ptlp 

pointer  to  Long_Point 

Development;SIMNET  :CEW; 
sea  intrsct.h 

slope 

double 

Standard  C  tyoe. 

pt2p 

pointer  to  Long_Point 

Development:SIMNET  :CEW: 
seq  intrsct.h 

pt3p 

pointer  to  Long_Point 

DevelopmentiSIMNET  ;CEW: 
sea  intrsct.h 

outcode 

short 

Standard  C  type. 

outp 

pointer  to  codedjpoint 

Development:SIMNET;CEW: 
seq  intrsct.h 

outp2 

pointer  to  codedjpoint 

Development;SIMNET  :CEW: 
seq  intrsct.h 

numout 


inter  to  short 


Standard  C  tvoe. 


internal  Variables 

''.triable 

Type 

Where  Typedef  Declared 

pjeftp 

pointer  to  Long_Point 

DevelopmentiSIMNET  :CEW: 
seq  intrsct.h 

p_rightp 

pointer  to  Long_Point 

Development.SIMNET  ;CEW; 
seq  intrsct.h 

pi  Jeftp 

pointer  to  Long_Point 

Development:SIMNET:CEW; 
seq  intrsct.h 

p1_rightp 

pointer  to  Long_Point 

DevelopmentiSIMNET  iCEW: 
seq  intrsct.h 

disti 

double 

Standard  C  type. 

dist2 

double 

Standard  C  type. 

delta  X 

double 

Standard  C  type. 

slope2 

double 

Standard  C  type. 
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1  Return  Values  I 

Return  Value 

Type 

Meaning 

ON_ONE_SIDE 

short 

The  segments  miss; 
separated  by  x  or  y. 

BOTH_ON_LINE_ABUTTING 

short 

The  given  segment  is  colinear 
to  another  and  the  vertices 
touch. 

BOTH  ON  LINE  OVERLAP 
PING 

short 

The  segments  are  colinear 
and  the  vertices  do  not  touch 

ON_LINE_TO_SIDE 

short 

A  vertex  is  on  an  extended 
line,  but  not  on  the  segment; 
there  is  no  intersection. 

ON_LINE_ABLnTING 

short 

One  pair  of  vertices  touch 

ON_LINE_MID_TOUCH 

short 

One  vertex  touches  the 
middle  of  the  given  semqnet 

MID_CROSS 

short 

The  line  segments  cross  in  the 
middle. 

MID_ABUTTING 

short 

The  given  segment  is  abutted 
by  the  other. 

Calls 

Function 

Where  Described 

POINT  TO  LINE 

Macro  defined  Development:SIMNET:CEW;seQ  intrsct.h. 

Called  By 

Function 

Where  Described 

seq  intrsct 

See  Section  2.19.4.3.1. 

Table  2.19-84  check__x_ints  Information. 

2.19.4.3.3  check_y_ints 

check_y_ints  checks  for  an  intersection  of  finite  line  segments.  The  two  segments  are 
defined  by  the  input  parameters  ptOp  to  ptlp  and  pt2p  to  pt3p.  The  slope  of  the  ptOp  to 
ptlp  segment  is  slope  (dx/dy),  and  is  assumed  to  be  between  - 1  and  1 .  A  description  code 
of  the  type  of  intersection  between  the  segments  is  returned,  outcode  contains  the  list  of  the 
intersection  codes  for  which  all  intersection  points  are  to  be  reported;  outp  and  outp2  are 
arrays  of  intersection  points,  coded  by  the  type  of  intersection  of  the  given  point;  numoutp 
is  the  number  of  coded_lpoints  that  are  valid  intersection  points.  The  function  call  is 
check_y_ints(ptOp,  ptlp,  slope,  pt2p,  pt3p,  outcode,  outp,  outp2,  numoutp).  Table  2.19- 
85  describes  the  parameters  used  and  functions  called  using  this  function. 


678 


BBN  Systems  and  Technologies 


MCC  CSCI 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

ptOp 

pointer  to  Long_Point 

Development:SIMNET  :CEW: 
sea  intrsct.h 

ptip 

pointer  to  Long_Point 

Deyelopment:SIMNET  ;CEW: 
sea  intrsct.h 

slope 


pt2p 


outcode 


outp 


outp2 


numout 


slope2 


double 


pointer  to  Long_Point 


pointer  to  Long_Point 


short 


pointer  to  codedjpoint 


pointer  to  codedjpoint 


inter  to  short 


Standard  C  t 


Development:SIMNET  :CEW: 
sea  intrsct.h 


Development:SIMNET  :CEW; 
sea  intrsct.h 


Standard  C  type. 


Deveiopment:SIMNET:CEW; 
sea  intrsct.h 


Development:SIMNET  :CEW: 
sea  intrsct.h 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

pjeftp 

pointer  to  Long_Point 

Deyelopment;SIMNET  :CEW: 
sea  intrsct.h 

p_rightp 

pointer  to  Long_Point 

Developmenl.SIMNET  :CEW: 
sea  intrsct.h 

pi  Jeftp 

pointer  to  Long_Point 

Development;SIMNET  :CEW: 
sea  intrsct.h 

p1_rightp 

pointer  to  Long_Point 

Deyelopment:SIMNET  :CEW: 
sea  intrsct.h 

dist1 

double 

Standard  C  type. 

dist2 

double 

Standard  C  type. 

double 


double 


Standard  C  type. 


Standard  C  type. 


Return  Values 

Return  Value 

Type 

Meaning 

ON_ONE_SIDE 

short 

The  segments  miss; 
separated  by  x  or  y. 

BOTH_ON_LINE_ABUTTING 

short 

The  given  segment  is  colinear 
to  another  and  the  vertices 
touch. 

BOTH  ON  LINE  OVERLAP 
PING 

short 

The  segments  are  colinear 
and  the  vertices  do  not  touch 

ON_LINE_TO_SIDE 

short 

A  vertex  is  on  an  extended 
line,  but  not  on  the  segment; 
there  is  no  intersection. 

ON_LINE_ABU7TING 

short 

One  pair  of  vertices  touch 

ON_LINE_MID_TOUCH 

short 

One  vertex  touches  the 
mid  Jle  of  the  given  semgnet 

MID_CROSS 

short 

The  line  segments  cross  in  the 
middle. 

MID_ABUTriNG 

short 

The  given  segment  is  abutted 
by  the  other. 
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1  Calls  1 

Function 

Where  Described 

POINT  TO  LINE 

Macro  defined  DevelODmenl;SIMNET:CEW;seq  intrscl.h. 

Called  Bv 

Function 

Where  Described 

seq  intrsct 

See  Section  2.19.4.3.1. 

Table  2.19-85  check_y_ints  Information. 

2.19.4.3.4  reverse_param 

reverse_param  reverses  the  x  and  y  coordinates  for  all  member  points  in  the  paramp 
parameter.  Member  points  include  ptOp,  ptlp,  the  points  in  the  pt  arr  array,  and  the  points 
in  the  outptsp  array.  The  function  call  is  reverse_param(paramp).  Table  2. 1 9-86  describes 
the  parameters  us^  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Tvoe 

Where  Typedef  Declared 

paramp 

pointer  to  segintparams 

DevelopmentiSiMNET  :CEW; 
seq  intrsct. h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

Calls 

Function 

Where  Described 

REVERSE  COORDS 

Macro  defined  Development:SIMNET:CEW:seq  intrsct. h. 

Table  2.19-86  reverse_param  Information. 
2.19.4.3.5  print_int_code 


print_int_code  prints  the  intersection  code  description  specified  by  the  parameter  n.  This 
function  is  only  compiled  if  DEBUG  is  1.  The  function  call  is  print_ini_code(n).  Table 
2.19-87  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

n 

short 

Standard  C  type. 

Called  By 

Function 

Where  Described 

seq  intrsct 

See  Section  2.19.4.3.1. 

Table  2.19-87  print_int_code  Information. 
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2.19.4.4  seg_intrsct.h 

Development:SIMNET:MCC:CEW  :seg_intrsct.h 

This  file  contains  macros  used  in  the  file  seg_intrsct.c.  It  also  contains  the  definitions  of 
the  segment  intersect  codes.  Structures  arc  defined  for  the  segparams  type,  the  point  type, 
the  Long  Poini  type,  and  the  coded  l point  type. 

The  segparams  type  stracture  is  composed  of  the  following  members; 

ptOp 

ptlp 
ptarr 
num _pt_arr 
abortcode 
num_code 
code  num  arr 


out jjtcode 
sizeout jJtsp 
out JJtsp 
numoutjjts 


2.19.5  CEW  Objects 


7  IQ  ^  1  PhprkI  i«t  c 

Development;SIMNET;MCC:CEW:CheckList.c 

This  file  contains  routines  for  setting  up  the  CheckLists.  CheckLists  are  windows 
containing  lists  of  items  with  check  boxes.  An  item  in  the  list  is  selected  by  clicking  in  the 
check  box. 

2.19.5.1.1  CheckList::init 

CheckList::init  allocates  and  initalizes  an  instance  of  a  CheckList  object,  window  is  the 
window  in  which  the  list  appears;  r  is  the  rectangle  containing  the  list's  viewable  content. 
The  function  call  is  CheckList: :init(WindowPtr  window,  Rect  r).  Table  2.19-88  describes 
the  parameters  used  and  functions  called  using  this  function. 


One  point  of  the  segment  to  be  tested. 

The  second  point  of  the  segment  to  be  tested. 

The  coruiected  segments  to  be  tested  against. 

The  number  of  points  in  the  array  pt  arr. 

The  intersection  codes  on  which  seg_intrsct()  should  abort. 
The  intersection  codes  which  seg_intrsctO  should  report. 

An  array  allocated  by  the  caller  and  intialized  to  0.  On  return 
it  contains  ti»e  number  of  intersections  found  with  each  code. 
For  example,  code_num_arr[MID_CROSS]  contains  the 
number  of  MIS_CROSS  intersections  found. 

The  intersection  codes  for  which  all  intersection  points 
should  be  reported. 

The  number  of  points  in  the  codedl  point  array,  allocated  by 
the  caller. 

The  array  of  intersection  points,  coded  by  the  type  of 
intersection  of  the  given  point. 

The  number  of  co^d  l points  that  are  valid  intersection 
points  on  return  of  seg_intrsct(). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

window 

WindowRr 

Development  THINK  C: 

Mac  #includes;WindowMgr.h 

r 

Rect 

DevelopmentTHINK  C; 

Mac  #includes;MacTvoes.h 

1  1 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

celLsize 

Cell 

DevelopmentTHINK  C: 

Mac  #includes:ListMgr.h 

datab 

Reel 

DevelopmentTHINK  C; 

Mac  #includes;MacTvpes.h 

listRect 

Rect 

DevelopmentTHINK  C: 

Mac  #includes;MacTvpes.h 

Return  Values 

Return  Value 

Type 

Meaning 

(Handle)  this 

Handle 

A  handle  to  the  CheckUst 
object  created. 

Calls 

Function 

Where  Described 

SetRect 

Standard  Quickdraw  function  for  Macintosh. 

SetPt 

Standard  Quickdraw  function  for  Macintosh. 

LNew 

Standard  List  Manaaer  function  for  Macintosh 

LSetSelect 

Standard  List  Manager  function  for  Macintosh 

LDoDraw 

Standard  List  Manager  function  for  Macintosh 

LUpdate 

Standard  List  Manager  function  for  Macintosh 

FrameRect 

Standard  Quickdraw  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

Resourceltems 

See  Section  2.19.3.7.1. 

Table  2.19>88  CheckList::init  Information. 


2.19.5.1.2  CheckList::AddRow 

CheckList::Ad(iRow  adds  a  row  to  the  list.  The  row  is  filled  in  with  information  from  the 
data  parameter.  The  check  box  is  set  to  state.  The  function  call  is 
CheckList::AddRow(state,  data).  Table  2.19-89  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

state 

short 

Standard  C  type. 

data 

Ptr 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

Variable 


celLsize 


dataPlr 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Development:THINK  C: 
Mac  #includes;ListMar.h 


DevelopmentTHINK  C: 
Mac  tincludes.MacTvpes.h 
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1  Calls  1 

Function 

Where  Described 

NewRr 

Standard  Memory  Manaaer  function  for  Macintosh. 

stxcpy 

See  Section  2.19.3.10.2. 

SetPt 

Standard  Quickdraw  function  for  Macintosh. 

LAddRow 

Standard  List  Manaaer  function  for  Macintosh 

LSetCell 

Standard  List  Manaaer  function  for  Macintosh 

LDraw 

Standard  List  Manaaer  function  for  Macintosh 

DisposRr 

Standard  Memory  Manaaer  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

Resourceltems 

See  Section  2.19.3.7.1. 

Table  2.19-89  CheckList::AddRow  Information. 


2.19.5.1.3  CheckList::SetRow 

CheckList::SetRow  fills  in  the  specified  row  with  the  input  state  and  data  information.  The 
function  call  is  CheckList:;SetRow(row,  state,  data).  Table  2.19-90  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


row 


data 


state 


Parameters 


short 


inter  to  char 


short 


lltS 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  tyoe. 


Standard  C  type. 


internai  Variabies 

Variable 

Where  Typedef  Declared 

cell_size 

Cell 

Development:THINK  C: 

Mac  #includes;ListMar.h 

dataRr 

Rr 

Deyelopment:THINK  C: 

Mac  #includes;MacTypes.h 

Function 


NewRr 


SetPt 


LSetCell 


LOraw 


DisocsPtr 


Calls 


Where  Described 


Standard  Memory  Manaaer  function  tor  Macintosh. 


See  Section  2.19.3.10.2. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  List  Manaaer  function  for  Macintosh 


Standard  List  Manaaer  function  for  Macintosh 


Standard  Memory  Manaaer  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

SetState 

See  Section  2.19.5.1.5. 

Table  2.19-90  CheckList::SctRo\v  Information. 
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2.19.5.1.4  CheckList;:GetRow 

CheckList:;GetRow  fills  in  the  data  and  state  pointers  with  the  data  and  state  information 
from  the  specified  row.  The  function  call  is  CheckList:;GetRow(row,  state,  data).  Table 
2.19-91  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

row 

short 

Standard  C  type. 

data 

pointer  to  char 

Standard  C  type. 

state 

pointer  to  short 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dataRr 

Str255 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

dataLen 

short 

Standard  C  type. 

cell_size 

Cell 

DevelopmentiTHINK  C: 

Mac  #includes;ListMar.h 

Calls 

Function 

Where  Described 

SetPt 

Standard  Quickdraw  function  for  Macintosh. 

LGetCell 

Standard  List  Manaoer  function  for  Macintosh 

StXCDV 

See  Section  2.19.3.10.2. 

Called  Bv 

Function 

Where  Described 

SetState 

See  Section  2.19.5.1.5. 

GetState 

See  Section  2.19.5.1.6. 

Table  2.19-91  CheckList::GetRow  Information. 


2.19.5.1.5  CheckList::SetState 

CheckList::SetState  sets  the  state  of  the  specified  row  to  state.  Each  row  in  the  CheckList 
contains  a  data  item  and  a  check  box.  The  item  is  selected  by  clicking  in  the  check  box; 
state  tells  whether  the  item  is  selected.  The  function  call  is  CheckList: :SetState(row,  state). 
Table  2.19-92  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

short 

Standard  C  type. 

row 

short 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

data 

Str255 

Development;THINK  C: 

Mac  #includes:MacTypes.h 

oldstate 

short 

Standard  C  type. 

1  1 
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_ _ Calls 

Function  [Where  Described 

Get  Row _ See  Section  2.19.5.1.4. 

SetRow_ See  Section  2.19.5.1.3. 


Called  B’ 


Function 

Where  Described 

ToQQleState 

See  Section  2.19.5.1.7. 

MissionOb 

j::edit 

See  Section  2.19.5.7.2. 

MissionCX) 

i;:NewMission 

See  Section  2.19.5.7.3. 

MissionObi:;show  I 

See  Section  2.19.5.7.4. 

Table  2.19-92  CheckList::SetState  Information. 
2.19.5.1.6  CheckList::GetState 


CheckList::GetState  returns  the  state  of  the  specified  row  in  the  CheckList.  Each  row  in  the 
CheckList  contains  a  data  item  and  a  check  box.  The  item  is  selected  by  clicking  in  the 
check  box;  state  tells  whether  the  item  is  selected.  The  function  call  is 
CheckList:;GetState(row).  Table  2.19-93  describes  the  parameters  used  and  functions 
called  using  this  function. 
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1  Called  By  \ 

Function 

Where  Described 

setEmplacementTime 

See  Section  2.19.3.2.4. 

CheckEmplacementDialoQ 

See  Section  2.19.3.2.5. 

setBreachTime 

See  Section  2.19.3.2.6. 

CheckBreachDialoQ 

See  Section  2.19.3.2.7. 

CheckMoveDialoQ 

See  Section  2.19.3.2.8. 

Resourceltems 

See  Section  2.19.3.7.1. 

ToaaleState 

See  Section  2.19.5.1.7. 

MjssionObi::edit 

See  Section  2.19.5.7.2. 

Table  2.19-93  CheckList::GetState  Information. 

2.19.5.1.7  CheckList:  :ToggIeState 

CheckList::ToggleState  changes  the  state  of  the  specified  row.  If  the  item  was  selected,  it 
is  changed  to  not  selected.  If  the  item  was  not  selected,  it  is  changed  to  selected.  The 
function  call  is  CheckList: :ToggleState(row).  Table  2.19-94  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

row 

short 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

X 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetState 

See  Section  2.19.5.1.6. 

SetState 

See  Section  2.19.5.1.5. 

1  Called  By  1 

Function 

Where  Described 

CheckList  Handler 

See  Section  2.19.3.7.2. 

Table  2.19-94  CheckList: :ToggleState  Information. 

2.19.5.2  CheckList.h 

Development:SIMNET:MCC:CEW  :CheckList.h 

This  file  contains  the  declaration  of  the  CheckList  class  as  a  child  (or  derivation)  of  the 
TextList  class. 

2.19.5.3  ComWindows.c 

Development:SIMNET:MCC:CEW:ComWindows.c 
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2.19.5.3.1  ComWindow::show 

ComWindow:;show  makes  the  ComWindow  visible  by  calling  the  Swindow  class 
declaration  member  function  show().  The  Asset  (or  Resource)  window  is  an  example  of  a 
ComWindow.  The  function  call  is  ComWindow:  :show().  Table  2.19-95  describes  the 
functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

Swindow:;show 

See  Section  2.19.5.13.2. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.19.2.1.1. 

SetupResWindow 

See  Section  2.19.3.8.2. 

Table  2.19-95  ComWindow::show  Information. 

2.19.5.3.2  ComWindow::AddHotSpot 

ComWindow:  :AddHotS pot  adds  a  hot  spot  to  the  ComWindow.  A  hot  spot  is  an  area  in 
the  window  which  performs  a  function  when  the  user  clicks  in  it  (e.g.  the  OK  button),  r  is 
the  outline  of  the  hot  spot  area::,fiinc  contains  the  functionality  of  the  hot  spot.  The  function 
call  is  ComWindow: ;AddHotSpot(Rect  r,  ProcPir  func).  Table  2. 19-96  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

r 

Rect 

Development:THINK  C: 

Mac  #includes;MacTvpes.h 

func 

ProcRr 

Development;THINK  C: 

Mac  #includes:MacTypes.h 

Calls 

Function 

Where  Described 

SetRect 

Standard  Quickdraw  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

Print  Window 

See  Section  2.19.3.6.1. 

SetupResWindow 

See  Section  2.19.3.8.2. 

Table  2.19-96  ConiWindow::AddHotSpot  Information. 
2.19.5.3.3  ComWindow: :initial 

ComWindow::initial  allocates  and  initializes  an  instance  of  a  ComWindow  object.  ID 
specifies  the  ID  number  of  the  window; /unc  specifies  the  window's  update  function.  The 
function  call  is  ComWindow::initial(short  ID,  ProcPtr  func).  Table  2.19-97  describes  the 
parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

c 

short 

Standard  C  type. 

func 

ProcRr 

Development:THINK  C: 

Mac  #includes:MacTvpes.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

this 

pointer  to  ComWindow 

A  handle  to  this  instance  of 
the  ComWindow  object. 

1  Calls  1 

Function 

Where  Described 

Swindow::init 

See  Section  2.19.5.13.1. 

1  Called  Bv  1 

Function 

Where  Described 

main 

See  Section  2.19.2.1.1. 

SetupResWindow 

See  Section  2.19.3.8.2. 

Table  2.19*97  CofnWmdow::initial  Information. 


2.19.5.3.4  ComWindow::CheckHotSpot 

ComWindow::CheckHotSpot  checks  to  see  if  the  mouse  point  is  in  a  hot  spot,  pt  is  the 
mouse  point.  The  function  call  is  ComWindow:;CheckHotSpot(Point  pt).  Table  2.19-98 
describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Called  By  1 

Function 

Where  Described 

MainEventLoop 

See  Section  2.19.2.1.2. 

OtherEventLoop 

See  Section  2.19.3.8.7. 

Table  2.19-98  CoinWindow::CheckHotSpot  Information. 


2.19.5.4  ComWindows.h 

Development;SIMNET:MCC:CEW:ComWindows.h 

This  file  contains  the  definition  of  the  HotSpot  type  structure  and  a  declaration  of  the 
ComWindow  class  as  a  child  of  the  Swindow  class. 

2.19.5.5  Dialog_Windows.c 

Development:SIMNET:MCC:CEW:Dialog_Windows.c 

This  file  contains  implementation  routines  for  Dialog  Windows. 

2.19.5.5.1  DialogWindow::init 

DialogWindow::init  ComWindow::initial  allocates  and  initializes  an  instance  of  a 
DialogWindow  object  ID  specifies  the  ID  number  of  the  window;  func  specifies  the 
window's  check  function;  hand  specifies  the  window's  special  handler  function.  The 
function  call  is  DialogWindow;:init(short  ID,  ProcPtr  func,  ProcPtr  hand).  Table  2.19-99 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

D 

short 

Standard  C  type. 

tunc 

ProcRr 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

hand 

ProcRr 

Development.THINK  C; 

Mac  #includes;MacTypes.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

this 

pointer  to  DialogWindow 

A  handle  to  this  instance  of 
the  DialogWindow  object. 

1  Calls  1 

Function 

Where  Described 

NewRr 

Standard  Memory  Manager  function  for  Maanfosh. 

GetNewDialoq 

Standard  Dialog  Manager  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

Macinits 

See  Section  2.19.2.1.3. 

Table  2.19-99  DialogWindow::init  Information. 
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2.19.5.5.2  DialogWindow::handler 


DialogWindow::handler  handles  events  in  DialogWindow  objects.  The  function  call  is 
DialogWindow::handler().  Table  2.19-100  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

itemhit 

short 

Standard  C  type. 

done 

short 

Standard  C  type. 

lastitem 

short 

Standard  C  type. 

aevent 

EventRecord 

Development.THINK  C‘ 

Mac  #includes;EventMgr.h 

c 

char 

Standard  C  type. 

short 

Standard  C  type. 

short 

Standard  C  type. 

hjtem 

Handle 

DevetopmentTHINK  C: 

Mac  #includes:MacTypes.h 

Ihjtem 

Handle 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

box 

Rect 

Development:THINK  C; 

Mac  #includes;MacTypes.h 

Ibox 

Rect 

DevelopmentiTHINK  C; 

Mac  #includes;MacTypes.h 

reset 

Boolean 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

special 

short 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

special 

short 

A  special  handler  function 
exists  for  this  DialogWindow 

itemhit 

short 

The  resource  id  of  the  item 
which  was  hit. 

1  Calls  1 

Function 

Where  Described 

SvsBeep 

Standard  Operating  System  Utility  tunction  for  Macintosh. 

SvstemTask 

Standard  Desk  Manager  function  for  Macintosh. 

GetNextEvent 

Standard  Toolbox  Event  Manager  function  for  Macintosh 

SpecialHandlerFunc 

CheckFunc 

IsOialooEvent 

Standard  Dialog  Manager  tunction  for  Macintosh. 

DialoqSelect 

Standard  Dialog  Manager  function  for  Macintosh. 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh 

1  Called  By  I 

Function 

Where  Described 

activate 

See  Section  2.19.5.5.3. 

Table  2,19-100  DialogWindow::handlcr  Information. 
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2.19.5.5.3  DialogWindow::activate 

DialogWindow;:activate  brings  the  DialogWindow  to  the  front,  and  makes  it  visible  and 
usable.  The  function  call  is  DialogWindow; :activate().  Table  2.19-101  describes  the 
internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

lastButlon 

short 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

last  Button 

short 

??? 

1  Calls  1 

Function 

Where  Described 

Show  Window 

Standard  Window  Manager  function  for  Macintosh. 

HiliteWindow 

Standard  Window  Manager  function  for  Macintosh. 

SelectWindow 

Standard  Window  Manager  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

OialoqOutlineltem 

See  Section  2.19.5.5.19. 

handler 

See  Section  2.19.5.5.2. 

close 

See  Section  2.19.5.5.6. 

1  Called  By  I 

Function 

Where  Described 

ReviewSelection 

See  Section  2.19.3.2.15. 

MissionSelection 

See  Section  2.19.3.5.3. 

MissionObj;;edit 

See  Section  2.19.5.7.2. 

MissionObi::show 

See  Section  2.19.5.7.4. 

Table  2.19-101  DialogWindow::activate  Information. 
2.19.5.5.4  DialogWindow: rquit 

DialogWindow:;quit  closes  the  dialog,  cleaning  up  its  memory  allocations.  The  function 
call  is  DialogWindow:  :quit().  Table  2.19-102  describes  the  functions  called  using  this 
function. 


1  Calls  1 

Function 

Where  Described 

Close  Dialog 

Standard  Dialog  Manager  function  for  Macintosh. 

DisposHandle 

Standard  Memory  Manager  function  for  Macintosh. 

DisposPtr 

Standard  Memory  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

DeleteResourceLists 

See  Section  2.19.3.7.3. 

Table  2.19-102  DialogWindow:;quit  Information. 
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2.19.5.5.6  DialogWindow::close 

DialogWindow::close  makes  the  DialogWindow  not  visible.  The  function  call  is 
DialogWindow::close().  Table  2.19-104  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

HideWindow 

Standard  Window  Manaqer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

activate 

See  Section  2.19.5.5.3. 

Table  2.19-104  DialogWindow::close  Information. 
2.19.5.5.7  DialogWindow::GetText 

DialogWindow:  :GetText  fills  in  the  text  string  pointer,  text,  with  the  text  value  of  item. 
The  function  call  is  DialogWindow:  :GetText(short  item,  char  text).  Table  2.19-105 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  i 

Parameter 

Type 

Where  Typedef  Declared 

item 

short 

Standard  C  type. 

text 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

1  Variable 

Type 

Where  Typedef  Declared 

short 

Standard  C  type. 

hjtem 

Handle 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

box 

Rect 

Development:THINK  C; 

Mac  #includes.MacTypes.h 

1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialoq  Manaqer  function  for  Macintosh 

GetIText 

Standard  Dialoo  Manaqer  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

isLeaalMinefield 

See  Section  2.19.3.2.2. 

setEmplacementTime 

See  Section  2.19  3.2.4 

CheckEmplacementDialoo 

See  Section  2.19.3.2  5 

setBreachTime 

See  Section  2.19.3.2.6 

1  Mill  II  MM  HIM— 1 

See  Section  2.19.3.2.7. 

CheckMoveDialog 

See  Section  2.19.3.2.8. 

DetermineMines 

See  Section  2.19.3.2.14. 

MissionObi:;edit 

See  Section  2  19.5  7  2 

Table  2.19-105  DialogWindowvfJetText  Information. 
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2.19.5.5.8  DialogWindow::SetText 

DialogWindow::SetText  sets  the  text  value  of  item  to  the  text  string  passed  in  text.  The 
function  call  is  DialogWindow::SetText(short  item,  char  text).  Table  2.19-106  describes 
the  parameters  used  and  functions  called  using  this  function. 


Parameter 


item 


text 


Parameters 


short 


inter  to  char 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  type. 


Variable 


e 


h  item 


Internal  Variables 


e 


short 


Handle 


Where  Typedef  Declared 


Standard  C  t 


DevelopmentiTHINK  C: 
Mac  #includes:MacTypes.h 


DevelopmentiTHINK  C: 
Mac  #includes;MacTypes.h 


Function 


GetDItem 


SetIText 


Calls 


Where  Described 


Standard  Dialoq  Manaoer  function  for  Macintosh. 


Standard  Dialog  Manager  function  for  Macintosh. 


Function 


setEmplacementTime 


CheckEmplacementDialo 


setBreachTime 


CheckBreachDialo 


DetermineMines 


MissionObiiiedit 


MissionObiiishow 


Called  B 


Where  Described 


See  Section  2.19.3.2.4. 


See  Section  2.19.3.2.5. 


See  Section  2.19.3.2.6. 


See  Section  2.19.3.2.7. 


See  Section  2.19.3.2.8. 


See  Section  2.19.3.2.14. 


See  Section  2.19.5.7.2. 


See  Section  2.19.5.7.4. 


Table  2.19-106  DialogWindow;:SetText  Information. 
2.19.5.5.9  DialogWindow::SelectText 

E>ialogWindow::SelectText  highlights  the  text  in  the  given  item.  The  function  call  is 
DialogWindow::SelectText(short  item).  Table  2.19-107  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameter 


item 


Parameters 


Where  Tvpedef  Declared 


Standard  C  type. 


Function 


SellText 


Calls 


Where  Described 


Standard  Dialog  Manager  function  for  Macintosh. 
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1  Called  Bv  1 

Function 

Where  Described 

CheckEmplacementDialog 

See  Section  2.19.3.2.5. 

MissionObi::edit 

See  Section  2.19.5.7.2. 

Table  2.19-107  DialogWindow::SelectText  Information. 
2.19.5.5.10  DialogWindow::GetValue 

DialogWindow::GetValue  returns  the  control  value  of  the  given  item.  The  function  call  is 
DialogWindow::GetValue(short  item).  Table  2.19-108  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

item 

short 

Standard  C  type. 

Internal  Variables 

1  Variable 

Where  Typedef  Declared 

short 

Standard  C  type. 

hjtem 

Handle 

DevelopmenttTHINK  C: 

Mac  #includes:MacTypes.h 

box 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes;MacTypes.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

GetCtlValue((ControlHarKlle) 
h  item) 

short 

The  control  yalue  of  the 
specified  item. 

1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

GetCtIValue 

Standard  Control  Manager  function  for  Macintosh. 

1  Called  Bv  1 

Function 

Where  Described 

CheckEmDiacementDialoq 

See  Section  2.19.3.2.5. 

DetermineMines 

See  Section  2.19.3.2.14. 

ReviewSelection 

See  Section  2.19.3.2.15. 

MissionObi;;edit 

See  Section  2.19.5.7.2. 

Table  2.19-108  DialogWindow::GetValue  Information. 
2.19.5.5.11  DialogWindow::SetValue 

DialogWindow.-.SetValue  sets  the  control  value  of  the  specified  item,  item  is  the 
DialogWindow  item;  value  is  the  control  value  to  set.  The  function  call  is 
DialogWindow::SetValue(short  item,  short  value).  Table  2.19-109  describes  the 
parameters  used  and  functions  called  using  this  function. 
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Parameters 


Parameter 


item 


value 


Variable 


e 


h  Item 


Internal  Variables 


short 


Handle 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  tvoe. 


Where  Tvoedef  Declared 


Standard  C  t 


DevelopmentiTHINK  C. 
Mac  #includes:MacTvDes.h 


Development:THINK  C; 
Mac  #includes;MacTyDes.h 


Function 


GetDItem 


SetCtI  Value 


Calls 


Where  Described 


Standard  Dialoa  Manaoer  function  for  Macintosh. 


Standard  Control  Manaoer  function  for  Macintosh. 


Function 


CheckEmolacementDialo 


CheckBreachDialo 


CheckReviewDialo 


ReviewSelection 


MissionObi:;edit 


MissionOb 


Called  B 


Where  Described 


See  Section  2.19.3.2.5. 


See  Section  2.19.3.2.7. 


See  Section  2.19.3.2.13. 


See  Section  2.19.3.2.15. 


See  Section  2.19.5.7.2. 


See  Section  2.19.5.7.4. 


Table  2.19-109  DialogWindow::SetVaIue  Information. 
2.19.5.5.12  DialogWindow::HiliteItem 

Dialog  Window;  ;HiliteItem  highlights  the  value  of  the  item,  item  is  the  DialogWindow 
item;  value  is  the  control  value  of  item.  The  function  call  is 
DialogWindow;;HiliteItem(short  item,  short  value).  Table  2.19-1 10  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


Item 


value 


Variable 


e 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard  C  tvpe. 


Standard  C  type. 


Where  Tvoedef  Declared 


Standard  C  type. 


hjtem 

Handle 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

box 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTyoes.h 
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1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialoa  Manaaer  function  for  Macintosh. 

HiliteControl 

Standard  Control  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

ReviewSelection 

See  Section  2.19.3.2.15. 

MissionObi::show 

See  Section  2.19.5.7.4. 

Table  2.19-110  DialogWindow::HiliteItein  Information. 
2.19.5.5.13  DiaIogWindow::SetUserItem 

DialogWindow::SetUserItem  sets  the  DialogWindow's  user  item  to  the  specified  handler 
routine.  This  user  specified  handler  routine  will  be  used  to  handle  events  while  the  dialog 
is  active,  item  is  the  user  item;  routine  is  the  handler  routine.  The  function  call  is 
DialogWindow::SetUserItem(shortitem,  ProcPtr  routine).  Table  2.19-111  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

item 

short 

Standard  C  type. 

routine 

ProcRr 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

Internal  Variables 

1  Variable 

Where  Typedef  Declared 

short 

Standard  C  type. 

hjtem 

Handle 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

box 

Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

SetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

Macinits 

See  Section  2.19.2.1.3. 

Table  2.19-111  DialogWindow::SelUserItem  Information. 
2.19.5.5.14  DialogWindow::GetItemRect 

DialogWindow::GetItemRect  returns  the  box  that  describes  the  specified  item.  The  tunction 
call  is  DialogWindow::GetItemRect( short  item).  Table  2. 19- 1 1 2  describes  the  parameters 
used  and  functions  called  using  this  function. 
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Parameter 


item 


Parameters 


Where  Typedef  Declared 


Standard  C  t 


Variable 


e 


h  Item 


Internal  Variables 


e 


short 


Handle 


Where  Typedef  Declared 


Standard  C  t 


Development;THINK  C; 
Mac  #includes;MacTvpes.h 


DevelopmentiTHINK  C: 
Mac  #includes:MacTYpes.h 


Return  Values 


Return  Value 


box 


Meaning 


The  box  that  describes  the 
item. 


Function 


GetDItem 


Calls 


Where  Described 


Standard  Dialoa  Manaaer  function  for  Macintosh. 


Function 


Resourceltems 


Called  B 


Where  Described 


See  Section  2.19.3.7.1. 


Table  2.19>112  DialogWindow::GetItemRect  Information. 
2.19.5.5.15  DialogWindow::equal 

DialogWindow.requal  deteraiines  if  other  is  the  same  dialog  as  this  object  instance.  The 
function  call  is  DidogWindow:;equal(WindowPtr  other).  Table  2.19-1 13  describes  the 
parameters  used  by  this  function. 


Parameters 


Parameter 


other 


WindowPtr 


Where  Typedef  Declared 


Development.THINK  C: 

Mac  #includes:WindowMQr.h 


Return  Value 


other  dialog 


Return  Values 


Boolean 


Meaning 


TRUE  if  Other  is  the  same 
dialog; 

FALSE  if  other  is  not  the 
same  dialo 


Called  B 


Function 

Where  Described 

Resourceltems 

See  Section  2.19.3.7.1. 

Table  2.19-113  DialogWindow::equal  Information. 
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2.19.5.5.16  DialogWindow::GetDialogPtr 

DialogWindow::GetDialogPir  returns  the  dialog  pointer  of  this  DialogWindow  object.  The 
function  call  is  DialogWindow::GetDialogPtr().  Table  2.19-1 14  describes  the  values 
returned  by  this  function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

dialog 

Dialog  Ptr 

The  dialog  pointer  of  this 
DialogWindow  object. 

Called  By 

Function 

Where  Described 

CheckEmplacementDialog 

See  Section  2.19.3.2.5. 

CheckBreachDialoa 

See  Section  2.19.3.2.7. 

CheckMoveDialoa 

See  Section  2.19.3.2.8. 

Table  2.19-114  DialogWindow::GetDialogPtr  Information. 
2.19.5.5.17  DialogWindow:  :BringToFront 

DialogWindowirBringToFront  brings  this  DialogWindow  to  the  front  of  the  screen.  The 
function  call  is  Dialog Window;;BringToFront().  Table  2.19-1 15  describes  the  functions 
called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

Hi  lite  Window 

Standard  Window  Manager  function  for  Macintosh 

Select  Window 

Standard  Window  Manager  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.19-115  DialogWindow::BringToFront  Information. 
2.19.5.5.18  DialogOutlineltem 

DialogOutlineltem  highlights  the  specified  item  in  the  specified  dialog,  dialog  is  the 
specified  DialogWindow;  itemNo  is  the  item  to  highlight.  The  function  call  is 
DialogOutlineItem(dialog,  itemNo).  Table  2.19-1 16  describes  the  parameters  used  and 
functions  called  using  this  function. 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

the  Item 

Handle 

Development.THINK  C: 

Mac  #includes:MacTypes.h 

r 

Rect 

Development:THINK  C: 

Mac  #includes:MacTvpes.h 

CP 

reaister  pointer  to  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

GetDItem 

Standard  Dialoa  Manaaer  function  for  Macintosh. 

InsetRect 

Standard  Quickdraw  function  for  Macintosh. 

GetHandleSize 

Standard  Memory  Manaaer  function  for  Macintosh. 

SetHandleSize 

Standard  Memory  Manaaer  function  for  Macintosh. 

MemError 

Standard  Memory  Manaaer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

Dialoq  Window:  :activate 

See  Section  2.19.5.5.3. 

Table  2.19-116  DialogOutlineltem  Information. 

2.19.5.6  DialogWindows.h 

Development:SIMNET:MCC:CEW:Dialog_Windows.h 


This  file  contains  the  declaration  of  the  DialogWindows  class. 


2.19.5.7  MissionObj.c 

Development:SIMNET:MCC:CEW;MissionObj.c 


This  file  implements  the  MissionObj  objects. 
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Variables 


Variable 

Where  Typedef  Declared 

emplace.dlog 

extern  pointer  to 

Dialoo  Window 

Development:SIMNET  :CEW: 
Dialoo  Windows.h 

breach_dlog 

extern  pointer  to 

DialooWindow 

DevelopmentiSIMNET  ;CEW; 
Dialoo  Windows.h 

move_dlog 

extern  pointer  to 

DialooWindow 

Development.SIMNET.CEW: 
Dialoo  Wirxfows.h 

stat_emplace 

extern  pointer  to 

DialooWindow 

Development;SIMNET:CEW: 
Dialoo  Windows.h 

stat_breach 

extern  pointer  to 

DialooWindow 

Development:SIMNET;CEW: 
Dialoo  Windows.h 

stat_move 

extern  pointer  to 

DialooWindow 

Development;SIMNET  ;CEW; 
Dialoo  Windows.h 

missionUst 

extern  pointer  to  TextUst 

Development;SIMNET  :CEW; 
TextList.h 

breach_availList 

pointer  to  CheckList 

Development;SIMNET  ;CEW: 
CheckList. h 

move_availList 

pointer  to  CheckList 

Development:SIMNET  :CEW: 
CheckList. h 

emplace.availList 

pointer  to  CheckList 

Development:SIMNET  ;CEW: 
CheckList. h 

stat_emplace_availList 

pointer  to  CheckList 

Development:SIMNET  :CEW; 
CheckList. h 

stat_move_availList 

pointer  to  CheckList 

Development:SIMNET  :CEW: 
CheckList. h 

stat_breach_availList 

pointer  to  CheckList 

Development:SIMNET  ;CEW: 
CheckList. h 

totalResources 

extern  short 

Standard  C  type. 

serviceq 

extern  pointer  to  ServiceObj 

Development:SIMNET:CEW: 
ServiceObj.  h 

cewResources 

extern  pointer  to  array  of 
ResourceObi 

DevelopmentiSIMNET  ;CEW: 
ResourceObi. h 

str  mission 

pointer  to  array  of  char 

Standard  C  type. 

Table  2.19-117  MissionObj.c  Variable  Information. 
2.19.5.7.1  MissionObj::init 

MissionObjr.init  initializes  and  allocates  an  instance  of  the  MissionObj  Object.  ID  h  an 
index  into  ^e  Mission  List.  The  function  call  is  MissionObj::init( short  ID).  Table  2. 19 
118  describes  the  parameters  used  and  functions  called  using  this  function. 

Parameters 


Parameter _ Type _ Where  Typedef  Declared 

ID_ short_ Standard  C  type. 


Return  Values 

Return  Value 

Type 

Meaning 

this 

pointer  to  MissionObj 

A  handle  to  this  instance  of 
the  MissionObj  Object. 
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1  Called  By  1 

Function 

Where  Described 

MissionSelection 

See  Section  2.19.3.5.3. 

Table  2.19-118  MissionObj::init  Information. 


2.19.5.7.2  MissionObj::edit 

MissionObj::edit  fills  in  the  correa  fields  when  the  user  edits  a  mission.  The  mission 
number,  the  start  and  finish  times,  the  depth  of  the  minefield,  and  the  number  of  mines 
required  are  filled  in.  edit  reason  is  the  reastm  for  the  edit  (either  because  a  new  mission  is 
being  created,  the  user  requested  an  edit  through  the  Review  dialog,  or  an  asset  was 
destroyed).  TTie  function  call  is  MissionObj::^t(edit_reason).  Table  2.19-1 19  describes 
the  parameters  used  and  functions  called  using  this  function. 


Parameter 


edit  reason 


Variable 


tempStr 


Parameters 


Internal  Variables 


e 


Str255 


temoLon 


temolnt 


last  Button 


mf  Dts 


the_dlog 


currentTime 


time  diff 


short 


short 


short 


short 


register  pointer  to 
DialoqWindow 


DateTimeGroup 


Where  Tvoedef  Declared 


Standard  C  type. 


Where  Tvoedef  Declared 


DevelopmentTHINK  C: 
Mac  #includes;MacTvpes.h 


Development:THINK  C: 
Mac  #includes:MacTvDes.h 


DevelopmentiTHINK  C: 
Mac  #includes:MacTvpes.h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Development:SIMNET  :CEW; 
Dialoo  Windows,  h 


Deyelopment:SIMNET  :iibmac: 
dta.h 


Standard  C  type. 


Return  Values 


Return  Value 


FALSE 


TRUE 


Type 


short 


short 


Meaning _ 


The  mission  was  aborted. 


The  mission  is  pending. 
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1  Calls  1 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

Dialoa  Window :  :SetT  ext 

See  Section  2.19.5.5.8. 

DialogWindow :  :SetValue 

See  Section  2.19.5.5.11. 

DTGToStrina 

See  Section  2.22.1.15.1. 

CheckList::SetState 

See  Section  2.19.5.1.5. 

DialoQ  Wi  ndow :  :SelectT  ext 

See  Section  2.19.5.5.9. 

Dialo<3Window::GetT  ext 

See  Section  2.19.5.5.7. 

DialogWindow:  iGetValue 

See  Section  2.19.5.5.10. 

CheckList::GetState 

See  Section  2.19.5.1.6. 

DialogWindow:  :activate 

See  Section  2.19.5.5.3. 

StringToDTG 

See  Section  2.22.1.15.2. 

Get  DTG 

See  Section  2.22.1.15.4. 

DTGEIapsed 

See  Section  2.22.1.15.3. 

CEDTGToString 

See  Section  2.19.3.10.8. 

^  1  kfci  r  t]  Ti  f 

See  Section  2.19.3.9.1. 

Text  List:  :SetRow 

See  Section  2.19.5.15.9. 

SetStatus 

See  Section  2.19.5.7.20. 

1  Called  By  I 

Function 

Where  Described 

ReviewSelection 

See  Section  2.19.3.2.15. 

NewMission 

See  Section  2.19.5.7.3. 

ServiceObi::CheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-119  MissionObj::edit  Information. 
2.19.5.7.3  MissionObj::NewMission 


When  the  user  selects  the  New  Mission  button  and  fills  in  the  proper  fields, 
MissionObj::NewMission  sets  up  a  new  mission  and  adds  it  to  the  appropriate  mission  list 
for  the  missionType  (either  Emplacement,  Breach,  or  Move).  The  mission  number,  the 
start  and  finish  times,  the  depth  of  the  minefield,  and  the  number  of  mines  required  are 
filled  in.  The  function  call  is  MissionObj::NewMission(short  missionType)  Table  2  19- 
120  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 

[Typ 

e 

Where  Typedef  Declared 

missionType 

1  short  1 

Standard  C  type. 
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Internal  Variables 


Variable 


tempStr 


Str255 


Str255 


Where  Typedef  Declared 


Development:THINK  C: 
Mac  #inctudes;MacTypes.h 


the  list 


currentTime 


Str255 

Development.THINK  C. 

Mac  #includes:MacTvpes.h 

pointer  to  CheckList 

Development;SIMNET  :CEW. 
CheckList. h 

DateTimeGroup 

DevelopmentiSIMNET  ;iibmac; 
dta.h 

short 

Standard  C  type. 

Return  Values 


Return  Value 


FALSE 


TRUE 


Meanin 


The  mission  was  not  created. 


The  mission  was  created. 


Function 


Get  DTG 


Notif 


CheckList;;SetState 


edit 


CEDTGToStri 


AssembleMissionStrin 


TextList;:AddRow 


SetStatus 


ServiceObi;;AddService 


Calls 


Where  Described 


See  Section  2.22.1.15.4. 


See  Section  2.19.3.4.4. 


See  Section  2.19.5.1.5. 


See  Section  2.19.5.7.2. 


See  Section  2.19.3.10.8. 


See  Section  2.19.3.9.1. 


See  Section  2.19.5.15.6. 


See  Section  2.19.5.7.20. 


See  Section  2.19.5.11.2. 


Function 


MissionSelection 


Called  B 


Where  Described 


See  Section  2.19.3.5.3. 


Table  2.19-120  MissionObj::NewMission  Information. 
2.19.5.7.4  MissionObj::show 

MissionObj::show  shows  the  current  mission,  show  reason  is  the  reason  the  mission  is 
being  shown  (either  because  the  user  asked  to  see  the  mission  through  the  Review  dialog, 
or  a  warning  just  came  due).  The  function  call  is  MissionObj::show(show_reason).  Table 
2.19-121  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


show  reason 


Where  Tvoedef  Declared 


Standard  C  tvoe. 
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Internal  Variables 

Variable 

Where  Typedef  Declared 

tempStr 

Str255 

Development;THINK  C; 

Mac  #includes;MacTvpes.h 

aStr 

Str255 

Developmenf.THINK  C; 

Mac  #includes;MacTvpes.h 

bStr 

Str255 

Development;THINK  C; 

Mac  #includes;MacTvpes.h 

lastButton 


time  diff 


new  start 


new  startA 


new  end 


currentTime 


the_dlog 


DateTimeGroup 


register  pointer  to 
DialooWindow 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


DevelopmentiSIMNET  :libmac; 
dta.h 


Development:SIMNET:CEW: 
DiaiOQ  Windows. h 


Function 


DialooWindow;  ;Hilite  Item 


DialooWindow ;  ;Set  Value 


NumToString 


DialooWindow :  :SetT  ext 


DTGToStri 


Checklist  ;:SetState 


DialooWindow;  ;activate 


StrinoToDTG 


Get  DTG 


DTG  Elapsed 


CEDTGToStri 


AssembleMissionStrin 


TextUst;;SetRow 


SetStatus 


Calls 


Where  Described 


See  Section  2.19.5.5.12. 


See  Section  2.19.5.5.11. 


Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 


See  Section  2.19.5.5.8. 


See  Section  2.22.1.15.1. 


See  Section  2.19.5.1.5. 


See  Section  2.19.5.5.3. 


See  Section  2.19.3.4.4. 


See  Section  2.22.1.15.2. 


See  Section  2.22.1.15.4. 


See  Section  2.22.1.15.3. 


See  Section  2.19.3.10.8. 


See  Section  2.19.3.9.1. 


See  Section  2.19.5.15.9. 


See  Section  2.19.5.7.20. 


Function 


ReviewSelection 


ServiceObi ;  ;CheckQs 


ServiceObi;;ShowQ 


Called  B 


Where  Described 


See  Section  2.19.3.2.15. 


See  Section  2.19.5.11.4. 


See  Section  2.19.5.11.5. 


Table  2.19-121  MissionObj::show  Information. 
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2.19.5.7.5  MissionObj::UpdateMissionString 


MissionObj::UpdateMissionString  updates  the  text  string  describing  the  mission  in  the 
mission  table.  The  function  call  is  MissionObj::UpdateMissionString().  Table  2.19-122 
describes  the  internal  variable  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

retval 

Str255 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

aStr 

Str255 

Development.THINK  C: 

Mac  #includes;MacTypes.h 

bStr 

Str255 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

tempStr 

Str255 

DevelopmentiTHINK  C: 

Mac  #includes;MacTypes.h 

1  Calls  1 

{Function  1 

Where  Described 

See  Section  2.19.3.10.8. 

AssembleMissionStrina 

See  Section  2.19.3.9.1. 

TextList::SetRow 

See  Section  2.19.5.15.9. 

SetStatus 

See  Section  2.19.5.7.20. 

GetStatus 

See  Section  2.19.5.7.21. 

1  Called  Bv  1 

Function 

Where  Described 

ReviewSelection 

See  Section  2.19.3.2.15. 

ResetMissionTime 

See  Section  2.19.5.7.17. 

Table  2.19-122  MissionObj::UpdateMissionString  Information. 


2.19.5.7.6  MissionObj :  :GetStartMoveTime 

MissionObj::GetStartMoveTime  returns  the  start  time  of  a  move  mission.  The  function  call 
is  MissionObj: :GetStartMoveTime().  Table  2.19-122  describes  the  values  returned  by  this 
function. 


1  Return  /alues  1 

Return  Value 

Type 

Meaning  | 

startMoveTime.dtgElapsed 

unsigned  long 

— !!■ 

1  Called  By  1 

Function 

Where  Described 

ReviewSelection 

See  Section  2.19.3.2.15. 

ServiceObj;  :CheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-123  MissionObj::GetStartMoveTime  Information. 
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2.19.5.7.7  Missi onObj :  iGetStart ActivityTime 

MissionObj::GetStartActivityTime  returns  the  start  time  of  an  emplacement  or  breach 
mission.  TTie  function  call  is  MissionObj::GetStartActivityTimeO.  Table  2.19-124 
describes  the  values  returned  by  this  function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

startActivityTime  dtgElapsed 

unsigned  long 

The  time  an  emplacement  or 
breach  mission  is  supposed  to 
start. 

Called  Bv 

Function 

Where  Described 

ReviewSelection 

See  Section  2.19.3.2.15. 

ServiceObi::CheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-124  MissionObj::GetStartActivityTime  Information. 
2.19.5.7.8  MissionObj::GetEndTime 

MissionObj::GetEndTime  returns  the  time  the  mission  ends.  The  function  call  is 
MissionObj:;GetEndTime().  Table  2. 19-125  describes  the  values  returned  by  this  function. 


1  Return  Values  I 

Return  Value 

Meaning 

endTime.dtgElapsed 

unsigned  long 

The  end  time  of  the  mission. 

1  Called  Bv  1 

Function 

Where  Described 

ReviewSelection 

See  Section  2.19.3.2.15. 

ServiceObi::CheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-125  MissionObj::GetEndTime  Information. 
2.19.5.7.9  MissionObj::SetStartMoveTime 

MissionObj::SetStartMoveTime  sets  the  start  time  of  a  move  mission,  new  iinit  is  i!ie  ncv\ 
start  time.  The  function  call  is  Mi.ssionObj::SetStartMoveTimc(new_time).  Table  2.19-126 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

new  time 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DTG  Elapsed 

See  Section  2.22.1.15.3. 
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1  Called  By  1 

Function 

Where  Described 

ReviewSelection 

See  Section  2.19.3.2.15. 

Table  2.19-126  MissionObj::SetStartMoveTime  Information. 


2.19.5.7.10  MissionObj::SetStartActlvityTime 

MissionObj:;SetStartActivityTime  sets  the  start  time  of  an  emplacement  or  breach  mission. 
new  time  is  the  new  mission  start  time.  The  function  call  is 

MissionObj::SetStaitActivityTime(new_time).  Table  2.19-127  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tyoedef  Declared 

new  time 

unsioned  lonq 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DIG  Elapsed 

See  Section  2.22.1.15.3. 

1  Called  By  1 

Function 

Where  Described 

ReviewSelection 

See  Section  2.19.3.2.15. 

ResetMissionTime 

See  Section  2.19.5.7.17. 

Table  2.19-127  MissionObj::SetStartActivityTime  Information. 


2.19.5.7.11  MissionObj::SetEndTime 


MissionObj::SetEndTime  sets  the  end  time  of  a  mission,  new  time  is  the  new  mission  end 
time.  The  function  call  is  MissionObj::SetEndTime(new_time).  Table  2.19-128  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

new  time 

unsigned  long 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DIG  Elapsed 

See  Section  2.22.1.15.3. 

1  Called  By  1 

Function 

Where  Described 

ReviewSelection 

See  Section  2.19.3.2.15. 

ResetMissionTime 

See  Section  2.19.5.7.17. 

Table  2.19-128  MissionObj::SetEndTime  Information. 
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2.19.5.7.12  MissionObj::GetNumber 


MissionObj::GetNumber  returns  the  index  into  the  mission  list  for  this  mission.  The 
function  cadi  is  MissionObj::GetNumber().  Table  2.19-129  describes  the  values  returned 
by  this  function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

number 

short 

The  index  into  the  mission  list. 

Called  By 

Function 

Where  Described 

ServiceObi;  :CheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-129  MissionObj::GetNuinber  Information. 


2.19.5.7.13  MissionObj::SetResStatus 


MissionObj::SetResStatus  sets  the  status  of  each  resource  assigned  to  this  mission,  state  is 
the  status  to  set.  The  function  call  is  MissionObj::SetResStatus( state).  Table  2.19-130 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

short 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

short 

Successful. 

1  Calls  1 

Function 

Where  Described 

ResourceObi::SetStatus 

See  Section  2.19.5.9.11. 

1  Called  By  1 

Function 

Where  Described 

ServiceObi;  rCheckQs 

See  Section  2.19.5.11.4 

Table  2.19-130  MissionObj::SetResStatus  Information. 
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2.19.5.7.14  MissionObj::UpdateResAssigned 


MissionObj:;UpdateResAssigned  updates  each  resource  assi^ed  to  this  mission  in  the 
mission  list.  The  function  call  is  MissionObj::UpdateResAssigned().  Table  2.19-131 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

Calls 

Function 

Where  Described 

ResourceObj;:SetMission 

See  Section  2.19.5.9.6. 

1  Called  Bv  1 

Function 

Where  Described 

SendStartMovement 

See  Section  2.19.5.7.24. 

Table  2.19-131  MisstonObj::UpdateResAssigned  Information. 
2.19.5.7.15  MissionObj::CheckResStatu.s 


MissionObj::CheckResStatus  checks  the  status  of  each  resource  assigned  to  this  mission. 
The  function  call  is  MissionObj::CheckResStatus().  Table  2.19-132  describes  the  internal 
variables  used  and  functions  c^ed  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

short 

One  or  more  of  the  resources 
are  not  ready. 

TRUE 

short 

All  resources  are  ready. 

1  Calls  1 

Function 

Where  Described 

ResourceObj::GetStatus 

See  Section  2.19.5.9.12. 

1  Called  BY  1 

Function 

Where  Described 

ServiceObixCheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-132  MissionObj::CheckResStatus  Information. 
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2.19.5.7.16  MissionObj::UpdateResPosition 

MissionObj::UpdateResPosition  updates  the  position  of  each  resource  assigned  to  this 
mission.  TTie  function  call  is  MissionObj::UpdateResPosition().  Table  2.19-133  describes 
the  internal  variables  used  and  functions  call^  using  this  function. 


1  internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

mp 

MapCoordi  nates 

DevelopmentiSIMNET  ;libmac: 
map.h 

Calls 

Function 

Where  Described 

St  ri  ngT oM  apCoordi  nates 

See  Section  2.22.1.26.1. 

ResourceObi::SetPosition 

See  Section  2.19.5.9.4. 

Called  By 

Function 

Where  Described 

ServiceObi;  :CheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-133  MissionObj::UpdateResPosition  Information. 
2.19.5.7.17  MissionObj::ResetMissionTime 

MissionObj::ResetMissionTime  recomputes  the  timing  of  a  mission.  The  function  call  is 
MissionObj::ResetMissionTime().  Table  2.19-134  describes  the  internal  variables  used  and 
functions  called  using  this  function. 
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Variable 


ttime 


the  list 


move  time 


activity  time 


end_pt 


start_pt 


string 


stnng2 


emss  number 


m57  number 


cewPlatoon  number 


line  charae  number 


aStr 


tempStr 


er  hr 


charoes 


lenqth 


oldftime 


newftime 


time  diff 


atime  elapsed 


ercent  done 


dtg 


current  time 


Internal  Variables 


e 


pointer  to  Checklist 


short 


short 


float 


float 


LongPt 


LongPt 


Str255 


Str255 


short 


short 


short 


short 


Str255 


Str255 


Str255 
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Where  Tvpedef  Declared 


Standard  C  t 


DevetopmentiSIMNET  :CEW: 
Checklist. h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Development-.SIMNET  ;libmac; 
lonopt.h 


DevelopmentiSiMNET  ;libmac; 
lonopt.h 


Development:THINK  C; 
Mac  #includes:MacTvpes.h 


Development:THINK  C: 
Mac  #includes;MacTypes.h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Development;THINK  C: 
Mac  #includes:MacTypes.h 


DevelopmentTHINK  C; 
Mac  #includes:MacTypes.h 


DevelopmentTHINK  C: 
Mac  #includes:MacTypes.h 


Standard  C  type. 


Standard  C  t 


Standard  C  type. 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Development:SIMNET.iibmac; 

dtQ.h 


Standard  C  type. 


Calls 


Function  Where  Described 


ResourceObj;;DistanceToSec  See  Section  2.19.5.9.9. 


ResourceObi;;GetStatus 


ResourceObi;;GetKind 


UTMTolonaPt 


DistBetween2Pts 


GetStatus 


SetStartActivityTime 


SetEndTime 


Get  DTG 


UpdateMissionStrin 


See  Section 


See  Section 


See  Section 


See  Section 


See  Section 


See  Section 


See  Section 


See  Section 


See  Section 


See  Section 


2.19.5.9.12. 


2.19.5.9.2. 


2,19.3.3.5. 


2.22.1.23.2. 


2.19.5.7.21. 


2.19.5.7.10. 


2.19.5.7.11. 


2.19.3.4.4. 


2.22.1.15.4. 


2.19.5.7.5. 
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1  Called  By  I 

Function 

Where  Described 

ProcessRequest 

See  Section  2.19.2.1.5. 

ServiceObi:  ;CheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-134  MissionObj::ResetMissionTiine  Information. 
2.19.5.7.18  MissionObj::DispatchResources 

MissionObj-DispatchResources  sends  a  message  to  each  resource  assigned  to  this  mission 
to  start  moving.  Resources  are  dispatched  and  then  arrive  at  their  destinations;  their  travel 
is  not  simulate.  The  function  call  is  MissionObj::DispatchResources().  Table  2.19-135 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

Calls 

Function 

Where  Described 

Send  Dispatch 

See  Section  2.19.5.7.29. 

Called  By 

Function 

Where  Described 

SendStartMovement 

See  Section  2.19.5.7.24. 

Table  2.19-135  MissionObj::DispatchResources  Information. 
2.19.5.7.19  MissionObj::ArrivalResources 

MissionObj::ArrivalResources  sends  a  message  to  each  resource  assigned  to  this  mission  to 
arrive  at  its  destination.  Resources  are  dispatched  and  then  arrive  at  their  destinations;  their 
travel  is  not  simulated.  The  function  call  is  MissionObj::ArTivalResources().  Table  2.19- 
136  describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SendArrival 

See  Section  2.19.5.7.30. 

1  Called  By  1 

■  Function 

Where  Described 

See  Section  2.19.5.7.25. 

Table  2.19-136  MissionObj:;ArrivalResources  Information. 


BBN  Systems  and  Technologies 


MCCCSCI 


2.19.5.7.20  MissionObj::SetStatus 

MissionObj;:SetStatus  sets  the  status  of  this  mission,  num  is  the  status  code  to  set  for  the 
mission.  A  mission  status  can  be  either  Aborted,  Pending,  Moving,  In  Progress,  or  Done. 
The  function  call  is  MissionObj::SetStatus(num).  Table  2.i9-137-describes  the  parameters 
used  and  functions  called  using  this  function. 


Parameter 


num 


Variable 


data 


Parameters 


Internal  Variables 


Type 


Str255 


Where  Tvpedef  Declared 


Standard  C  t 


Where  Tvpedef  Declared 


DevelopmentiTHINK  C: 
Mac  #includes:MacTypes.h 


Function 


TextList::GetRow 


ReolaceMissionField 


TextList:;SetRow 


Calls 


Where  Described 


See  Section  2.19.5.15.10. 


See  Section  2.19.3.9.3. 


See  Section  2.19.5.15.9. 


Function 


ReviewSelection 


edit 


NewMission 


show 


UpdateMissionStrin 


ServiceObi::CheckQs 


Called  B 


Where  Described 


See  Section  2.19.3.2.15. 


See  Section  2.19.5.7.2. 


See  Section  2.19.5.7.3. 


See  Section  2.19.5.7.4. 


See  Section  2.19.5.7.5. 


See  Section  2.19.5.11.4. 


Table  2.19'137  MissionObj::SetStatus  Information. 
2.19.5.7.21  MissionObj::GetStatus 

MissionObj::GetStatus  returns  the  status  code  for  this  mission.  The  function  call  is 
MissionObj;:GetStatus().  Table  2.19-138  describes  the  values  returned  by  this  function. 


Return  Values 


Return  Value 


status 


Meaning _ 


This  mission's  status. 


Function 


ProcessReouest 


ReviewSelection 


UpdateMissionStrin 


ResetMissionTime 


ServiceObi:;CheckQs 


Called  B 


Where  Described 


See  Section  2.19.2.1.5. 


See  Section  2.19.3.2.15. 


See  Section  2.19.5.7.5. 


See  Section  2.19.5.7.17. 


See  Section  2.19.5.11.4. 


Table  2.19'138  MissionObj::GetStatus  Information. 
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2.19.5.7.22  MissionObj'.'.GetType 

MissionObj:;GetType  returns  the  type  of  this  mission.  Mission  types  can  be  either 
Emplacement,  Breach,  or  Move.  The  function  call  is  MissionObj::GetType().  Table  2.19- 
139  describes  the  values  returned  by  this  function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

type 

short 

This  mission's  type. 

Table  2.19-139  MissionObj::GetType  Information. 

2.19.5.7.23  MissionObj::GetOrderType 

MissionObjtrGetOrderType  returns  the  order  type  of  this  mission.  Missions  can  either  be 
Warned  or  Execute.  The  function  call  is  MissionObj::GetC)rderType().  Table  2.19-140 
describes  the  values  returned  by  this  function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

order type 

short 

This  mission's  order  type. 

Called  Bv 

Function 

Where  Described 

ServiceObi;;CheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-140  MissionObjr.GetOrderType  Information. 
2.19.5.7.24  MissionObj::SendStartMovement 

MissionObi::SendStartMovement  dispatches  the  resources  for  this  move  mission.  The 
function  call  is  MissionObj::SendStartMovemcnt().  Table  2.19-141  describes  the  functions 
called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

UpdateResAssianed 

See  Section  2.19.5.7.14. 

DispatchResources 

See  Section  2.19.5.7.18. 

Called  By 

Function 

Where  Described 

ServiceObi:  :CheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-141  MissionObj::SendStartMovement  Information. 
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2.19.5.7.25  MissionObj:  :SendStart  Activity 

MissionObj::SendStartActivity  starts  the  mission  activity  when  the  resources  have  arrived. 
The  function  call  is  MissionObj: :SendStartActivity().  Table  2.19-142  describes  the 
functions  called  using  this  function. 


Internal  Variables 

Variable 

Tvoe 

Where  Tvoedef  Declared 

req 

pointer  to 

CEWEmolaceReauest 

DevelopmentiSIMNET  :CEW: 
CEW.h 

rsp 

CEWEmplaceResponse 

Development:SIMNET  :CEW: 
CEW.h 

err _ short _ Standard  C  type. _ 

j _  short _ Standard  C  type. _ 

tempStr  Str255  Development:THINK  C: 

Mac  #includes:MacTypes.h 
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1  Calls  1 

Function 

Where  Described 

NewRr 

Standard  Memory  Manaaer  function  for  Macintosh. 

UTMToLonaR 

See  Section  2.19.3.3.5. 

ATPPut 

See  Section  2.22.1.3.3. 

ShowCaution 

See  Section  2.22.1.4.1. 

DisposRr 

Standard  Memory  Manager  function  for  Macintosh. 

TextList::GetRow 

See  Section  2.19.5.15.10. 

ReplaceMissionField 

See  Section  2.19.3.9.3. 

TextList::SetRow 

See  Section  2.19.5.15.9. 

Called  Bv 

Function 

Where  Described 

SendEndMission 

See  Section  2.19.5.7.26. 

Table  2.19-144  MissionObj::SendEmplacement  Information. 


2.19.5.7.28  MissionObj::SendBreach 

MissionObj::SendBreach  sends  information  to  the  host  process  about  the  completed 
minefield  breach.  The  function  call  is  MissionObj;:SendBreach().  Table  2.19-145 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

req 

pointer  to 

CEWEmplaceReouest 

Development:SIMNET  :CEW: 
CEW.h 

rsp 

CEWEmplace  Response 

Development.SIMNET.CEW: 

CEW.h 

err 

short 

Standard  C  type. 

i 

short 

Standard  C  type. 

tempStr 

Str255 

DevelopmentiTHINK  C; 

Mac  #includes:MacTypes.h 

1  Calls  1 

Function 

Where  Described 

NewRr 

Standard  Memory  Manager  function  for  Macintosh 

UTMToLonaPt 

See  Section  2.19.3.3.5. 

ATPPut 

See  Section  2.22.1.3.3. 

ShowCaution 

See  Section  2.22.1.4.1. 

DisoosPtr 

Standard  Memory  Manager  function  for  Macintosh. 

TextList::GetRow 

See  Section  2.19.5.15.10. 

ReplaceMissionField 

See  Section  2.19.3.9.3. 

TextList;:SetRow 

See  Section  2.19.5.15.9. 

1  Called  By  1 

Function 

Where  Described 

SendEndMission 

See  Section  2.19.5.7.26. 

Table  2.19-145  Mission()bj;:SendBreach  Information. 
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2.19.5.7.29  MissionObj::SendDispatch 

MissionObj::SendDispatch  sends  a  message  to  the  host  process  saying  that  a  resource  has 
been  dispatched,  num  specifies  the  resource.  The  function  call  is 
MissionObj:;SendDispatch(num).  Table  2. 19-146  describes  the  parameters  used  and 
functions  c^led  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

num 

short 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

pointer  to 

CEWEmplaceRequest 

DevelopmentiSIMNET  :CEW: 
CEW.h 

rsp 

C  E  WEmplace  Response 

Development:SlMNET:CEW: 

CEW.h 

err 

short 

Standard  C  type. 

tempStr 

Slr255 

Development:THINK  C; 

Mac  #includes;MacTypes.h 

1  Calls  1 

Function 

Where  Described 

NewRr 

Standard  Memory  Manaoer  function  for  Macintosh. 

ResourceObj::GetCCVNumbe 

r 

See  Section  2.19.5.9.3. 

ATPPut 

See  Section  2.22.1.3.3. 

ShowCaution 

See  Section  2.22.1.4.1. 

DisposPtr 

Standard  Memory  Manaqer  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

DisoatchResources 

See  Section  2.19.5.7.18. 

Table  2.19-146  MissionObj::SendDispatch  Information. 
2.19.5.7.30  MissionObj::Send  Arrival 

MissionObj::SendArrival  sends  a  message  to  the  host  process  saying  that  a  resource  has 
arrived,  num  specifies  the  resource.  The  function  call  is  MissionObj::SendArrival(num). 
Table  2.19-147  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

num 

short 

Standard  C  type. 

BBN  Systems  and  Technologies 


MCC  CSCI 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

req 

pointer  to 

CEWEmplaceRequest 

Development;SIMNET:CEW; 

CEW.h 

rsp 

CEWEmplaceResponse 

Development:SiMNET  :CEW; 
CEW.h 

err 

short 

Standard  C  type. 

coord 

UTMCoordinates 

Development:SIMNET  :CEW: 
SimnetTvpes.h 

Ip 

LongPt 

Development:SIMNET  :libmac: 
lonqpt.h 

Calls 

Function 

Where  Described 

NewRr 

Standard  Memory  Manaaer  function  for  Macintosh. 

Resou  rceObj :  :GetCC  V  Numbe 
r 

See  Section  2.19.5.9.3. 

ResourceObi::GetPosition 

See  Section  2.19.5.9.7. 

ATPPut 

See  Section  2.22.1.3.3. 

ShowCaution 

See  Section  2.22.1.4.1. 

DisposPtr 

Standard  MenKiry  Manaaer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

ArrivalResources 

See  Section  2.19.5.7.19. 

Table  2.19-147 


MissionObj::SendArrival  Information. 


2.19.5.8  MissionObj.h 

Development:SIMNET:MCC:CEW:MissionObj.h 


This  file  contains  definitions  of  mission  and  order  types,  and  edit  and  show  reasons.  It 
also  contains  the  type  definition  of  MinefieldType,  and  the  declaration  of  the  MissionObj 
class. 


2.19.5.9  ResourceObj.c 

Development:SIMNET:MCC:CEW:ResourceObj.c 

This  file  implements  the  ResourceObj  objects. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

str  rel 

pointer  to  array  of  char 

Standard  C  type. 

Table  2.19-148  ResourceObj.c  Variable  Information. 
2.19.5.9.1  ResourceObj  ::init 


ResourceObj ::init  initializes  this  resource  object.  The  resource  is  given  its  initial  attributes 
as  follows:  akind  is  the  kind  of  resource;  ajiame  is  the  name  of  the  resource,  speed  is  the 
maximum  speed  of  the  resource;  cev  is  the  host  value  stored  as  the  cev  number.  The 
function  call  is  ResourceObj: :init(akind,  a_namc,  speed,  ccv).  Table  2.19-149  describes 
the  parameters  used  and  functions  called  using  this  function 
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Parameters 


Parameter 


akind 


a_name 


speed 


ccv 


Where  Tvoedef  Declared 


Standard  C  t 


Development:THINK  C: 
Mac  #jncludes;MacTvpes.h 


Standard  C  t 


Standard  C  t 


Variable 


Internal  Variables 


e 


array  of  255  char 


Where  Tvoedef  Declared 


Standard  C  type. 


Return  Value 


this 


Return  Values 


Type 


pointe'’  to  ResourceObj 


Meanin 


A  handle  to  this  instance  o' 
the  ResourceObi  object. 


Function 


Calls 


Where  Described 


See  Section  2.19.3.10.3. 


Called  B 


Functiori 

Where  Described 

ProcessRequest 

See  Section  2.19.2.1.5. 

LoadCannedResources 

See  Section  2.19.3.1.2. 

Table  2.19*149  ResourceObj;;init  Information. 

2.19.5.9.2  ResourceObj::GetKind 

ResourceObj :;GetKind  returns  the  kind  of  this  re  .ojrce.  The  function  call  is 
ResourceObj; :GeiKind().  Table  2.19-150  describes  the  values  returned  by  this  function. 


Return  Values 

Return  Value 

Type 

Meaning 

kind 

long 

This  resource's  kind. 

Function 


setEmplacementTime 


CheckEmplacementDialo 


setBreachTime 


CheckBreachDialo 


MissionObj:;ResetMission 

Time 


Called  B 


Where  Described 


See  Section  2.19.3.2.4. 


See  Section  2.19.3.2.5. 


See  Section  2.19.3.2.6. 


See  Section  2.19.3.2.7 


See  Section  2.19.5.7.17. 


Table  2.19-150  ResourceObj::GetKind  Information. 
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2.19.5.9.3  ResourceObj::GetCCVNumber 

ResourceObj::GetCCVNumber  returns  the  ccv  number  of  this  resource.  The  function  call 
is  ResourceObj::GetCCVNumber().  Table  2.19-151  describes  the  values  returned  by  this 
function. 


Return  Values 


Return  Value 


ccv  number 


Meaning  _ 


This  resource's  ccv  number. 


Function 


ProcessReauest 


MissionOb 


MissionObi::SendArrival 


Called  B 


Where  Described 


See  Section  2.19.2.1.5. 


See  Section  2.19.5.7.29. 


See  Section  2.19.5.7.30. 


Table  2.19-151  ResourceObj::GetCCVNumber  Information. 
2.19.5.9.4  ResourceObj::SetPosition 

ResourceObj::SetPosition  sets  the  position  of  this  resource,  location  is  the  (x,y)  coordinate 
of  the  position.  The  routine  checks  the  validity  of  the  passed  location.  The  function  call  is 
ResourceObj::SetPosition(location).  Table  2.19-152  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 
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1  Called  By  1 

Function 

Where  Described 

ProcessRequest 

See  Section  2.19.2.1.5. 

LoadCannedResources 

See  Section  2.19.3.1.2. 

MissionObj::UpdateRes 

Position 

See  Section  2.19.5.7.16. 

Table  2.19-152  ResourceObj::SetPosition  Information. 
2.19.5.9.5  ResourceObj : :GetMission 

ResourceObj::GetMission  returns  the  mission  assignment  for  this  resource.  The  function 
caU  is  ResourceObj  ::GetMission().  Table  2.19-153  describes  the  values  returned  by  this 
function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

missionAssigned 

short 

The  mission  assignment  of 
this  resource. 

Called  By 

Function 

Where  Described 

ProcessRequest 

See  Section  2.19.2.1.5. 

SetupResWindow 

See  Section  2.19.3.8.2. 

Table  2.19-153 


ResourceObj::GetMission  Information. 


2.19.5.9.6 


ResourceObj::SetMission 


ResourceObj:;SetMission  assigns  this  resource  to  the  mission  specified  by  m.  The  function 
call  is  ResourceObj::SetMission(m).  Table  2.19-154  describes  the  parameters  used  by  this 
function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

m 

short 

Standard  C  type. 

1  Called  By  1 

Function 

Where  Described 

MissionObj;:UpdateRes 

Assigned 

See  Section  2.19.5.7.14 

Table  2.19-154  ResourceObj::SetMission  Information. 


2.19.5.9.7  ResourceObj ::GetPosition 

ResourceObj "GetPosition  fills  in  the  parameter  poj  with  the  (x,y)  coordinates  of  this 
resource's  position.  The  function  call  is  ResourceObj::GetPosition(pos).  Table  2.19-155 
describes  the  parameters  used  by  this  function. 
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1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pos 

pointer  to  LongR 

Development:SIMNET  :libmac: 
lonqpt.h 

Called  By 

Function 

Where  Described 

MissionObj;;SendArrival 

See  Section  2.19.5.7.30. 

Table  2.19-155  ResourceObj::GetPosition  Information. 


2.19.5.9.8  ResourceObj::GetKph 


ResourceObj::GetKph  returns  the  travel  speed  of  this  resource  (in  knVhr).  The  function  call 
is  ResourceObj::GetKph().  Table  2.19-156  describes  the  values  returned  by  this  function. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

kmj3er_hr 

short 

The  speed  of  this  resource. 

Table  2.19-156  ResourceObj::GetKph  Information. 


2.19.5.9.9  ResourceObj :  :DistanceToSecs 

ResourceObj::DistanceToSecs  calculates  the  length  of  time  it  will  take  this  resource  to  travel 
to  the  passed  UTM  location,  location.  The  function  caU  is 

ResourceObj::DistanceToSecs(location).  Table  2.19-157  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameter 


location 


Variable 


start  _pt 


end_pt 


meters  per  second 


dis 


Return  Value 


OL 


Parameters 


UTMCoordinates 


Internal  Variables 


e 


LongPt 


LongPt 


Where  Tvoedef  Declared 


Development:SIMNET  :CEW: 
SimnetTvoesh 


Where  Typedef  Declared 


Development:SIMNET  ilibmac: 
lonaot.h 


Development:SIMNET  ;libmac: 
lonaot.h 


Standard  C  t 


Return  Values 


Type 


unsigned  long 


unsigned  long 


Meaning  _ 


The  resource’s  current 
position  is  location. 


The  time  it  will  take  this 
resource  to  travel  to  location. 
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1  Calls  1 

Function 

Where  Described 

UTMToLonqR 

See  Section  2.19.3.3.5. 

DistBetween2Pts 

See  Section  2.22.1.23.2. 

Called  Bv 

Function 

Where  Described 

setBreachTime 

See  Section  2.19.3.2.6. 

CheckMoveDialoq 

See  Section  2.19.3.2.8. 

MissjonObj.'.'ResetMission 

Time 

See  Section  2.19.5.7.17. 

Table  2.19-157  ResourceObj::DistanceToSe€s  Information. 


2.19.5.9.10  ResourceObj::GetName 

ResourceObj::GetName  fills  in  a  name  with  the  vehicle  name  of  this  resource.  The 
function  call  is  ResourceObj:;GetName(a_name).  Table  2.19-158  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

a_name 

Rr 

DevelopmentTHINK  C; 

Mac  #includes:MacTvpes.h 

1  Calls  1 

Function 

Where  Described 

stpcpy 

[See  Section  2.19.3.10.3. 

1  Called  By  1 

Function 

Where  Described 

ProcessRequest 

See  Section  2.19.2.1.5. 

Resourceltems 

See  Section  2.19.3.7.1. 

Table  2.19-158  ResourceObj::GetName  Information. 


2.19.5.9.11  ResourceObj::SetStatus 

ResourceObj-SetStatus  sets  this  resource's  status  to  stat.  The  function  call  is 
ResourceObj::SetStatus(stat).  Table  2.19-159  describes  the  parameters  used  by  this 
function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

stat 

short 

Standard  C  type. 

1  Called  By  1 

Function 

Where  Described 

ProcessRequest 

See  Section  2.19.2.1.5. 

LoadCannedResources 

See  Section  2.19.3.1.2. 

MissionObj::SetResStatus 

See  Section  2.19.5.7.13. 

Table  2.19-159  ResourceObj::SetStatus  Information. 


723 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.19.5.9.12  ResourceObj::GetStatus 

ResouiceObj;:GetStatus  returns  the  status  of  this  resource.  The  function  call  is 
ResouiceObj::GetStatus().  Table  2.19-160  describes  the  values  returned  by  this  function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

status 

short 

The  status  of  this  resource. 

Called  By 

Function 

Where  Described 

SetupResWindow 

See  Section  2.19.3.8.2. 

MissionObj;:CheckResStatus 

See  Section  2.19.5.7.15. 

MissionObj :  :ResetMission 

Time 

See  Section  2.19.5.7.17. 

Table  2.19-160  ResourceObj::GetStatus  Information. 
2.19.5.9.13  ResourceObj::show 

ResourceObj::show  fills  in  the  parameter  string  with  relevent  information  about  the 
position,  status,  and  speed  of  this  resource.  The  function  call  is 
ResourceObj::show(string).  Table  2.19-161  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

[Parameter 

Where  Typedef  Declared 

1  string 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

tempStr 

Str255 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

1  Calls  1 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

AssembleResourceStrinq 

See  Section  2.19.3.9.2. 

1  Called  By  I 

Function 

Where  Described 

SetupResWindow 

See  Section  2.19.3.8.2. 

Table  2.19-161  ResourceObj::show  Information. 

2.19.5.10  ResourceObj.h 

Development:SlMNET;MCC:CEW:ResourceObj.h 

This  file  declares  the  ResourceObj  object  class. 
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2.19.5.11  ServiceObj.c 
Development:SIMNET:MCC:CEW  :ServiceObj.c 

This  file  implements  the  ServiceObj  objects. 

2.19.5.11.1  ServiceObj  ::init 

ServiceObj.'.'init  initializes  and  allocates  an  instance  of  a  ServiceObj  object.  The  ServiceObj 
object  contains  the  queue  of  events.  The  function  call  is  ServiceObj:  :init().  Table  2.19-162 
describes  the  values  returned  by  this  function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

this 

pointer  to  ServiceObj 

A  handle  to  the  ServiceObj 
object  created. 

Called  Bv 

Function 

Where  Described 

Macinits 

See  Section  2.19.2.1.3. 

Table  2.19>162  ServiceObj: :init  Information. 

2.19.5.11.2  ServiceObj::AddService 

ServiceObj ::AddService  adds  an  event,  a  mission,  to  the  end  of  the  ServiceList  queue. 
The  function  call  is  ServiceObj::AddService(a_mission).  Table  2.19-163  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

a_mission 

pointer  to  MissionObj 

Development:SIMNET  :CEW: 
MissionObj. h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

P 

Service  Rr 

DevelopmentiSIMNET  :CEW; 
ServiceObj.  h 

q 

ServiceRr 

Development:SIMNET  :CEW: 
ServiceObj. h 

1  Calls  1 

Function 

Where  Described 

NewRr 

Standard  Memory  Manaaer  function  for  Macintosh. 

CheckOs 

See  Section  2.19.5.11.4. 

i  Called  By  1 

Function 

Where  Described 

MissionObi;;NewMission 

See  Section  2.19.5.7.3. 

Table  2.19-163  ServiceObj::AddService  Information. 
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2.19.5.11.3  Servi!ceObj::DeleteService 


ServiceObj::DeleteService  removes  an  event,  x,  from  the  ServiceList  queue.  The  function 
call  is  ServiceObj::DeleteService(x).  Table  2.19-164  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

X 

pointer  to  MissionObj 

Development:SIMNET  :CEW; 
MissionObj. h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

P 

Service  Ptr 

Development:SIMNET  :CEW; 
ServiceObj.h 

q 

ServiceRr 

Development:SIMNET  :CEW: 
ServiceObj.h 

1  Calls  1 

Function 

Where  Described 

DisDOsPtr 

Standard  Memory  Manaqer  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

CheckQs 

See  Section  2.19.5.11.4. 

Table  2.19-164 


Sei'viciObj::DeleteService  Information. 


2.19.5.11.4  ServiceObj::CheckQs 


ServiceObj::CheckQs  checks  all  the  services  on  the  queue  for  start  times,  resource  arrival 
times,  and  completion. 


If  a  scheduled  mission's  execution  time  has  occurred,  the  routine  checks  the  mission's 
order  type.  If  the  order  type  is  Warn,  the  routine  props  up  a  dialog  to  the  user  allowing  the 
user  to  choose  to  either  execute  or  abort  the  mission.  If  the  order  typje  is  Execute,  the 
routine  executes  the  mission.  If  the  resources  allocated  to  the  mission  have  had  a  change  in 
status,  the  mission  is  aborted. 

Pending  missions  are  checked,  and  are  removed  from  the  ServiceList  if  they  have 
completed.  Move  missions  are  checked,  and  their  activity  started  if  the  resources  have 
completed  their  travelling. 

The  function  call  is  ServiceObj::ChcckQs().  Table  2.19-165  describes  the  internal  variables 
used  and  functions  called  using  this  function. 
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Variable 


time 


tempStr 


Internal  Variables 


e 


Service  Rr 


Service  Rr 


unsianed  Ion 


Str255 


Where  Tvoedef  Declared 


Development  iSIMNET  :CEW: 
ServiceObj.h 


DevelopmentiSIMNET  :CEW; 
ServiceObi.h 


Standard  C  t 


DevelopmentiTHINK  C: 
Mac  #includes:MacT 


Standard  C  t 


Function 


GetDateTime 


MissionObj:  :GetStartMoveTim 
e 


MissionObj::GetStatus 


MissionObi::GetOrderTvDe 


MissionObj :  :GetNumber 


MissionObi::show 


MissionOb|;:CheckResStatus 


MissionObj ;  iSetStatus 


MissionObj;;edit 


MissionObj::ResetMission 

Time 


MissionObj  "SendStartMovem 
ent 


MissionObj::SetResStatus 


MySound 


MissionObj;  :GetEndTime 


MissionObj;;SendEndMissjon 


DeleteService 


MissionObj::GetStartActivityTi 

me 


MissionObj.-UpdateRes 

Position 


MissionOb 


Calls 


Where  Described 


Standard  Ooeratina  System  Utility  function  for  Macintosh. 


See  Section  2.19.5.7.6. 


See  Section 


See  Section 


See  Section 


See  Section 


See  Section 


See  Section 


See  Section 


See  Section 


See  Section 


2.19.5.7.21. 


2.19.5.7.23. 


2.19.5.7.12. 


2.19.3.4.4. 


2.19.5.7.4. 


2.19.5.7.15. 


2.19.5.7.20. 


2.19.5.7.2. 


2.19.5.7.17. 


See  Section  2.19.5.7.24. 


See  Section  2.19.5.7.13. 


See  Section  2.19.3.4.5. 


See  Section  2.19.5.7.8. 


See  Section  2.19.5.7.26. 


See  Section  2.19.5.11.3. 


See  Section  2.19.5.7.7. 


See  Section  2.19.5.7.16. 


See  Section  2.19.5.7.25. 


Function 


ReviewSelection 


AddService 


UpdateOs 


Called  B 


Where  Described 


See  Section  2.19.3.2.15. 


See  Section  2.19.5.11.2. 


See  Section  2.19.5.11.6. 


Table  2.19-165  ServiceObj;:CheckQs  Information. 
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2.19.5.11.5  ServiceObj::ShowQ 
ServiceObj::ShowQ  is  not  currently  called  by  the  ^plication. 


Variable 


Internal  Variables 


e 


Service  Ptr 


IDTX 


SenricePtr 


Where  Tvpedef  Declared 


Deveiopment:SIMNET  :CEW; 
ServtceObi.h 


Deveiopment:SIMNET  :CEW; 
ServiceObi.h 


Calls 


Function  Where  Described 


MissionObj::show  See  Section  2.19.5.7.4. 


Table  2.19-166  ServiceObj::ShowQ  Information. 

2.19.5.11.6  ServiceObj::UpdateQs 

ServiceObj::UpdateQs  checks  the  service  queues  for  any  events  occurring  at  the  current 
time.  The  function  call  is  ServiceObj::UpdateQs().  Table  2.19-167  describes  the  internal 
variables  used  and  functions  called  using  this  function. 


Variable 


now 


Function 


GetDateTime 


CheckQs 


Function 


MainEventLoo 


Internal  Variables 


lEIT:! 


Where  Tvpedef  Declared 


Standard  C  type. 


Calls 


Where  Described 


Standard  Operatino  System  Utility  function  for  Macintosh. 


See  Section  2.19.5.11.4. 


Called  B 


Where  Described 


See  Section  2.19.2.1.2. 


Table  2.19-167  ServiceObj::UpdateQs  Information. 

2.19.5.12  ServiceObj.h 

Development:SIMNET:MCC:CEW:ServiceObj.h 

This  file  defines  the  Service  structure  type  and  declares  the  ServiceObj  class. 

2.19.5.13  SimpIe_Windows.c 

Development;SIMNET;MCC;CEW;Simple_Window.c 

This  file  implements  the  Swindow  object  utilities. 
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2.19.5.13.1  Swindow::init 

Swindow::init  initializes  and  allocates  an  instance  of  an  Swindow  object  ID  specifies  the 
ID  number  of  the  window;  func  specifies  the  simple  window’s  update  function.  The 
function  call  is  Swindow:  :init( short  ID,  ProcPtr  func).  Table  2.19-168  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  { 

Parameter 

Type 

Where  Typedef  Declared 

D 

short 

Standard  C  type. 

func 

ProcRr 

DevelopmentiTHINK  C: 

Mac  #includes;MacTypes.h 

Return  Values 

Return  Value 

Type 

Meaning 

this 

pointer  to  Swindow 

A  handle  to  the  Swindow 
object  created. 

Calls 

Function 

Where  Described 

NewPtr 

Standard  Memory  Manaaer  function  for  Macintosh. 

GetNewWindow 

Standard  Window  Manaaer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

ComWindow::initial 

See  Section  2.19.5.3.3. 

Table  2.19<168  Swindow::init  Information. 


2.19.5.13.2  Swindow::show 


Swindow::show  makes  the  simple  window  visible.  The  function  call  is  Swindow; :show(). 
Table  2.19-169  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

Show  Window 

Standard  Window  Manaaer  function  for  Macintosh. 

Set  Port 

Standard  Quickdraw  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

ComWindow:;show 

See  Section  2.19.5.3.1. 

BringToFront 

See  Section  2.19.5.13.9. 

Table  2.19-169  Swindow::show  Information. 
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2.19.5.13.3  Swindow::quit 

Swindow::quit  closes  this  simple  window,  cleaning  up  its  memory  allocations.  The 
function  call  is  Swindow::quit().  Table  2.19-170  describes  the  functions  called  using  this 
function. 


1  Calls  1 

Function 

Where  Described 

Dispose  Window 

Standard  Window  Manaoer  function  for  Macintosh. 

DisposPtr 

Standard  Memory  Manaoer  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

MacQuit 

See  Section  2.19.2.1.4. 

DoneStatus 

See  Section  2.19.3.8.5. 

OtherEventLoop 

See  Section  2.19.3.8.7. 

Table  2.19-170  Swindow::quit  Information. 

2.19.5.13.4  Swindow::update 

Swindow::update  redraws  the  simple  window,  calling  the  toolbox  functions  BeginUpdate 
and  EndUpdate.  The  function  call  is  Swindow::update().  Table  2.19-171  describes  the 
internal  variables  used  and  functions  called  using  this  function. 


j  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

cport 

GrafRr 

DevelopmentiTHINK  C: 
Mac#includes: 

1  Calls  1 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

BeqinUpdate 

Standard  Window  Manager  function  for  Macintosh. 

EndUpdate 

Standard  Window  Manager  function  for  Macintosh. 

1  Called  Bv  1 

Function 

Where  Described 

ReviewSelection 

See  Section  2.19.3.2.15. 

MissionSelection 

See  Section  2.19.3.5.3. 

OtherEventLoop 

See  Section  2.19.3.8.7. 

Table  2.19-171 


Swindow::update  Information. 
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2.19.5.13.5  Swindow::hide 


Swindow::hide  makes  the  simple  window  not  visible.  The  function  call  is 
Swindow::hide().  Table  2.19-172  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

Hide  Window 

Standard  Window  Manaaer  function  for  Macintosh. 

Table  2.19-172  Swindow::hide  Information. 


2.19.5.13.6  Swindow::IsVisible 


S window:  tIsVisible  returns  a  flag  which  says  whether  or  not  this  simple  window  is  visible. 
The  function  call  is  Swindow::IsVisible().  Table  2.19-173  describes  the  values  returned  by 
this  function. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

visible 

short 

If  0,  the  Swindow  is  not  visible; 

If  1 ,  the  Swindow  is  visible. 

Called  By 

Function 

Where  Described 

Print  Window 

See  Section  2.19.3.6.1. 

RefreshWindow 

See  Section  2.19.3.8.3. 

Table  2.19-173  Swindow::IsVisible  Information. 


2.19.5.13.7  Swindow::close 


Swindow::close  closes  this  simple  window.  The  window  is  taken  down  and  made  not 
visible.  The  function  call  is  Swindow::close().  Table  2.19-174  describes  the  functions 
called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

Close  Window 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.19-174  Swindow::close  Information. 


2.19.5.13.8  Swindow::equal 

Swindow::equal  determines  if  other  is  the  same  simple  window  as  this  object  instance. 
The  function  call  is  Swindow::equal(WindowPtr  other).  Table  2.19-175  describes  the 
parameters  used  by  this  function. 

_ _ Parameters _ _ 

Parameter _ Type _ Where  Typedef  Declared 

other  WindowPtr  DevelopmentiTHINK  C: 

Mac  #includes:WindowMar.h 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

window  ==  other 

Boolean 

TRUE  if  other  is  the  same 
simple  window; 

FALSE  if  other  is  not  the 
same  simple  window. 

Called  By 

Function 

Where  Described 

MainEventLoop 

See  Section  2.19.2.1.2. 

OtherEventLoop 

See  Section  2.19.3.8.7. 

Table  2.19-175  Swindow::equal  Information. 

2.19.5.13.9  Swindow::BringToFront 

S window: :BringToFront  brings  this  Swindow  to  the  front  of  the  screen.  The  function  call 
is  Swindow::BringToFront().  Table  2.19-176  describes  the  functions  called  using  this 
function. 


1  Calls  1 

Function 

Where  Described 

show 

See  Section  2.19.5.13.2. 

HiliteWindow 

Standard  Window  Manaoer  function  for  Macintosh. 

SelectWindow 

Standard  Window  Manaoer  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.19-176  Swindow: :BringToFront  Information. 
2.19.5.13.10  Swindow:  :GetWindowPtr 

Swindow: :GetWindowPtr  returns  the  window  pointer  of  this  Swindow  object.  The 
function  call  is  Swindow: :GetWindowPtr().  Table  2.19-177  describes  the  values  returned 
by  this  function. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

window 

WindowRr 

The  window  pointer  of  this 
simple  window  object. 

Called  By 

Function 

Where  Described 

MainEventLoop 

See  Section  2.19.2.1.2. 

Print  Window 

See  Section  2.19.3.6.1. 

SetupResWindow 

See  Section  2.19.3.8.2. 

RefreshWindow 

See  Section  2.19.3.8.3 

DoneStatus 

See  Section  2.19.3.8.5. 

OtherEventLoop 

See  Section  2.19.3.8.7. 

Table  2.19-177  Swlndow::GetWindowPtr  Information. 
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2.19.5.14  SimpIe_Windows.h 

Development:SIMI^T:MCC:CEW:simple_Windows.h 

This  file  contains  the  declaration  of  the  Swindow  class. 

2.19.5.15  TextList.c 

Development:SIMNET  :MCC:CEW  :TextLisLc 

This  file  implements  the  TextList  objects. 

2.19.5.15.1  TextList::init 


TextList:  :init  allocates  and  initializes  an  instance  of  a  TextList  object  window  is  the 
window  in  which  the  list  appears;  r  is  the  rectangle  containing  the  list's  viewable  content. 
The  function  call  is  TextList::init(WindowPtr  window,  Rect  r).  Table  2.19-178  describes 
the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

window 

j  WindowPtr 

DevetopmentiTHINK  C: 

Mac  #includes:WindowMgr.h 

DevelopmentTHINK  C: 
Mac  #jncludes;MacTvDes.h 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

celLsize 

Cell 

Development-.THINK  C: 

Mac  #includes:ListMar.h 

datab 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

li  street 

Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTvoes.h 

Return  Values 

Return  Value 

Type 

Meaning 

(Handle)  this 

Handle 

A  handle  to  the  TextList  object 
created. 

Function 


SetRect 


SelPt 


LNew 


LSetSelect 


LDoDraw 


LUpdate 


FrameRect 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  List  Manaaer  function  for  Macintosh 


Standard  List  Manaaer  function  for  Macintosh 


Standard  List  Manaaer  function  for  Macintosh 


Standard  List  Manaaer  function  for  Macintosh 


Standard  Quickdraw  function  for  Macintosh. 
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1  Called  By  1 

Function 

Where  Described 

main 

See  Section  2.19.2.1.1. 

SetupResWindow 

See  Section  2.19.3.8.2. 

Table  2.19-178  TextList::init  Information. 


2.19.5.15.2  TextList::ListUpdate 


TextList::ListUpdate  redraws  the  text  list.  The  function  call  is  TextList::ListUpdate(). 
Table  2. 19-179  describes  the  functions  called  using  this  function. 


1  Calls  1 

1  Function  1 

Where  Described 

IIPJ 

Standard  List  Manaoer  function  for  Macintosh 

1  FrameRect 

Standard  Quickdraw  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

Resourceltems 

See  Section  2.19.3.7.1. 

RefreshWindow 

See  Section  2.19.3.8.3. 

Table  2.19-179  TextList::ListUpdate  Information. 


2.19.5.15.3  TextList::ListDispose 


TextList::ListDispose  removes  (or  disposes)  this  text  list.  The  function  call  is 
TextList;:ListDispose().  Table  2.19-180  describes  the  functions  called  using  this  function. 


k  Calls  1 

Function 

Where  Described 

LDispose 

Standard  List  Manager  function  for  Macintosh 

1  Called  By  1 

Function 

Where  Described 

MacQuit 

See  Section  2.19.2.1.4. 

DeleteResourceLists 

See  Section  2.19.3.7.3. 

DoneStatus 

See  Section  2.19.3.8.5. 

See  Section  2.19.3.8.7. 

Table  2.19-180  TextList::ListDispose  Information. 


2.19.5.15.4  TextList::GetCellRect 


Textl.ist::GetCellRect  returns  the  rectangle  surrounding  a  cell  (or  row)  in  the  TextList. 
rcwNum  specifies  the  cell.  The  function  call  is  TextList: :GetCellRect(short  rowNum). 
Table  2.19-181  describes  the  parameters  used  and  functions  called  using  this  function. 

Parameters 


Parameter _ Type _ Where  Typedet  Declared 

rowNum  short  Standard  C  type. 
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Internal  Variables 

Variable 

Where  Typedef  Declared 

celLsize 

Cell 

DevelopmentiTHINK  C: 

Mac  #includes:ListMar.h 

DevelopmentTHINK  C: 
Mac  #includes;MacT 


Return  Value 


Return  Values 


Meanin 


The  rectangle  surrounding  the 
specified  cell. 


Function 


SetPt 


LRect 


FrameRect 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Standard  List  Manaaer  function  for  Macintosh 


Standard  Quickdraw  function  for  Macintosh. 


Function 


MainEventLoo 


Called  B 


Where  Described 


See  Section  2.19.2.1.2. 


Table  2.19-181  TextList::GetCelIRect  Information. 
2.19.5.15.5  TextList::GetCount 

TextList::GetCount  returns  the  number  of  items  in  this  TextList.  The  function  call  is 
TextList::GetCouni().  Table  2.19-182  describes  the  values  returned  by  this  function. 


Return  Values 


Return  Value 


count 


Meaning _ 


The  number  of  items  on  this 
list. 


Function 


setEmplacementTime 


CheckEmplacementDialo 


setBreachTime 


CheckBreachDialo 


CheckMoveDialo 


Called  B 


Where  Described 


See  Section  2.19.3.2.4. 


See  Section  2.19.3.2.5. 


See  Section  2.19.3.2.6. 


See  Section  2.19.3.2.7. 


See  Section  2.19.3.2.8. 


Table  2.19-182  TsxtList::GetCount  Information. 

2.19.5.15.6  TextList::AddRow 

TextList: :AddRow  adds  a  row  to  the  list.  The  row  is  filled  in  with  information  from  the 
data  parameter.  The  function  call  is  TextList::AddRow(data).  Table  2.19-183  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


data 


inter  to  char 


Where  Tvoedef  Declared 


Standard  C  type. 
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Internal  Variables 


Variable _ Type _ Where  Tvpedef  Declared 

cell_size  Cell  Development:THINK  C: 

Mac  #includes:UstMgr.h 


Calls 

Function 

Where  Described 

SetPt 

Standard  Quickdraw  function  for  Macintosh. 

L Add Row 

Standard  List  Manaaer  function  for  Macintosh 

LSetCell 

Standard  List  Manaaer  function  for  Macintosh 

LDraw 

Standard  List  Manaaer  function  for  Macintosh 

Called  B' 


Function _ Where  Described _ 

SetupResWindow _ See  Section  2.19.3.8.2. _ 

MissionOb|j^NewM^^ 

Table  2.19-183  TextList::AddRow  Information. 

2.19.5.15.7  TextList::DeleteRow 

TextList::DeleteRow  removes  the  specified  row  from  this  text  list.  The  function  call  is 
TextList::DeleteRow(short  rowNum).  Table  2.19-184  describes  the  parameters  used  and 
functions  called  using  this  function. 

Parameters  ~ 

Parameter  {Type  I  Where  Typedef  Declared 

rowNum_ short   Standard  C  type. 


_ _ Calls _ 

Function  [Where  Described 

LDelRow  Standard  List  Manager  function  tor  Macintosh 

Table  2.19-184  TextList::DeleteRow  Information. 

2.19.5.15.8  TextList::  Mark  Row 

TextList:;MarkRow  highlights  the  row  specified  by  rowNum  in  this  text  list.  The  function 
call  is  TextList::MarkRow(rowNum).  Table  2. 19-185  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 


Parameter 

e 

Where  Typedef  Declared 

rowNum 

1  short  1 

Standard  C  type. 

BBN  Systems  and  Technologies _ _ MCC  CSCI 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

penState 

PenState 

Developmenf.THINK  C: 

Mac  #includes:Quickdraw.h 

r 

Rect 

Hill 

c 

Cell 

DevelopmentTHINK  C: 

Mac  #includes:ListMar.h 

1  Calls  1 

Function 

Where  Described 

SetPt 

Standard  Quickdraw  function  for  Macintosh. 

LRect 

Standard  List  Manaaer  function  for  Macintosh 

GetPenState 

Standard  Quickdraw  function  for  Macintosh. 

PenMode 

Standard  Quickdraw  function  for  Macintosh. 

PenPat 

Standard  Quickdraw  function  for  Macintosh. 

PaintRect 

Standard  Quickdraw  function  for  Macintosh. 

SetPenState 

Standard  Quickdraw  function  for  Macintosh. 

\ 

Table  2.19-185  TextList::MarkRow  Information. 


2.19.5.15.9  TextList::SetRow 

TextList::SetRow  fills  in  the  specified  row  with  the  input  data  information.  The  function 
call  is  TextList::SetRow(row,  data).  Table  2.19-186  describes  the  parameters  used  and 
functions  called  using  this  function. 
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1  Called  By  1 

Function 

Where  Described 

MissjonObi::edit 

See  Section  2.19.5.7.2. 

MissionObi::show 

See  Section  2.19.5.7.4. 

MissionObj-UpdateMissionStr 

ing 

See  Section  2.19.5.7.5. 

MissionObi;:SetStatus 

See  Section  2.19.5.7.20. 

MissionObj::SendEmplace 

ment 

See  Section  2.19.5.7.27. 

MissionObj :  :SendBreach 

See  Section  2.19.5.7.28. 

Table  2.19-186  TextList::SetRow  Information. 


2.19.5.15.10  TextList::GetRow 


TextList:;GetRow  fills  in  a  data  pointer  with  the  data  inframadon  from  the  specified  row. 
The  function  call  is  TextList::GetRow(row,  data).  Table  2.19-187  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

row 

short 

Standard  C  type. 

data 

Str255 

Development:THINK  C: 

Mac  #includes;MacTvpes.h 

Internal  variables 

Variable 

Where  Typedef  Declared 

dataPtr 

Str255 

DevelopmentrTHINK  C: 

Mac  #jncludes;MacTvpes.h 

datalen 

short 

Standard  C  type. 

celLsize 

Cell 

DevelopmentTHINK  C: 

Mac  #includes;ListMqr.h 

1  Calls  1 

Function 

Where  Described 

SetPt 

Standard  Quickdraw  function  for  Macintosh. 

LGetCell 

Standard  List  Manager  function  for  Macintosh 

StXCDV 

See  Section  2.19.5.15.13. 

1  Called  By  I 

Function 

Where  Described 

MissionObj :  iSetStatus 

See  Section  2.19.5.7.20. 

MissionObj ;  :SendEmplace 
ment 

See  Section  2.19.5.7.27, 

MissionObi:;SendBreach 

See  Section  2.19.5.7.28. 

Table  2.19-187  TextList::GetRow  Information. 
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2.19.5.15.11  TextList::ListProc 
TextList::ListProc  is  not  called  by  the  application. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

thePt 

Point 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

theMods 

short 

Standard  C  type. 

xstring 

Str255 

Development.THINK  C: 

Mac  #includes:MacTypes.h 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

dataRr 

Str255 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

dc 

short 

Standard  C  type. 

cellnum 

short 

Standard  C  type. 

dataLen 

short 

Standard  C  type. 

i 

short 

Standard  C  type. 

a  cell 

Iona 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

-1 

short 

not  used. 

cellnum 

short 

not  used. 

1  Calls  1 

Function 

Where  Described 

LLastClick 

Standard  List  Manager  function  for  Macintosh 

HiWord 

Standard  Toolbox  Utility  function  for  Macintosh. 

LCIick 

Standard  List  Manager  function  for  Macintosh 

RInRect 

Standard  Quickdraw  function  for  Macintosh. 

LGelCell 

Standard  List  Manager  function  for  Macintosh 

stxcpy 

See  Section  2.19.5.15.13. 

Table  2.19-188  TextLi$t::ListProc  Information. 


2.19.5.15.12  TextList::ListlCiick 


ListlQick  prwesses  a  mouse  click  in  this  text  list.  thePt  is  the  point  of  the  mouse  click; 
theMods  specifies  any  modifier  keys  to  the  mouse  click;  xstring  is  the  user  entered  string. 
The  function  call  is  ListlClick(thePt,  theMods,  xstring).  Table  2.19-189  describes  the 
parameters  used  and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

thePt 

Point 

DevelopmentiTHINK  C; 

Mac  #includes;MacTvpes.h 

theMods 

short 

Standard  C  type. 

xstring 

Str255 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 
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Internal  Variables 


Variable 


dataRr 


dc 


cellnum 


dataLen 


a  cell 


Str255 


Where  Tvoedef  Declared 


Development:THINK  C: 
Mac  #includes:MacTypes.h 


Standard  C  t 


Standard  C  t 


Standard  C 


Standard  C  t 


Standard  C  t 


Return  Value 


cellnum 


Return  Values 


Meanin 


Unsuccessful. 


Which  cell  was  clicked  on. 


Calls 

Function 

Where  Described 

LCIick 

Standard  List  Manaoer  function  for  Macintosh 

LLastClick 

Standard  List  Manaoer  function  for  Macintosh 

HiWord 

Standard  Toolbox  Utility  function  for  Macintosh. 

RInRect 

Standard  Quickdraw  function  for  Macintosh. 

LGetCell 

Standard  List  Manaoer  function  for  Macintosh 

See  Section  2.19.5.15.13. 


Function 


Called  B 


Where  Described 


See  Section  2.19.2.1.2. 


See  Section  2.19.3.7.2. 


See  Section  2.19.3.8.7. 


Table  2.19-189  TextList::ListlClick  Information. 

2.19.5.15.13  stxcpy 

stxcpy  copies  the  C  string  pointed  to  by  p  into  another  C  string  pointed  to  by  c.  niun  is  the 
number  of  characters  in  the  string.  The  function  call  is  stxcpy(s,  p,  num).  Table  2. 19-190 
describes  the  parameters  used  by  this  function. 
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1  Called  Bv  1 

Function 

Where  Described 

TextList::GetRow 

See  Section  2.19.5.15.10. 

TextList:  :ListProc 

See  Section  2.19.5.15.11. 

TextUst::List1  Click 

See  Section  2.19.5.15.12. 

Table  2.19<190  stxcpy  Information. 

2.19.5.16  TextList.h 

Development:  SIMNET  :MCC:CEW  iTextListh 


This  file  contains  the  declaration  of  the  TextList  class. 
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2.20  The  Network  Communication  Libraries 

There  are  a  number  of  shared  libraries  that  various  processes  of  the  MCC  use.  Below  is  a 
section  on  each  library  with  a  brief  description  of  the  functions  it  provides.  This  structure 
of  this  CSC  is  shown  in  Figure  2.20-1. 


Figure  2.20*1:  Network  Communication  Libraries. 

2.20.1  libassoc 

The  SIMNET  Association  Layer  provides  network  services  to  send/receive  datagrams  and 
exactly  once  (xo)  transactions.  It  also  provides  a  subscription  service  to  multicast 
addresses  on  the  network,  allowing  an  individual  application  to  selectively  accept  or  reject 
network  traffic  from  different  SIMNET  exercises,  and  different  protocols  within  an 
exercise.  More  information  on  the  Association  Layer  can  be  found  in  “BBN  Report  No. 
7102,  The  SIMNET  Network  and  Protocols”.  Libassoc  communicates  with  the  network 
through  libnetif  to  provide  these  services. 

Libassoc  allows  an  application  to  open  multiple  association  channels,  one  per  network 
device  to  be  used.  Once  a  channel  is  opened,  it  is  referred  to  by  the  application  through  a 
unique  handle,  which  is  returned  after  successfully  opening  the  channel. 

When  an  error  occurs  in  a  libassoc  function,  it  is  indicated  by  an  otherwise  impossible 
returned  value.  This  is  almost  always  -1;  the  individual  descriptions  specify  the  details. 
An  error  number  is  made  available  in  the  external  variable  assoc_eimo.  Table  2.20-1  lists 
the  various  libassoc  errors. 
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Error  # 

Error  Name 

Description 

1 

ANETOPEN 

CoukJ  not  open  network  •  The  net_open  call  to  libnetif  failed. 
Make  sure  the  network  is  up  and  mnnino- 

3 

ANETACCESS 

CoukJ  not  access  network  -  This  is  a  catch-all  for  failed  calls 
into  libnetif.  Once  the  network  has  successfully  been 
opened,  the  most  common  problem  is  running  out  of  send 
buffers.  Additional  information  on  failed  net  calls  is  available 
bv  checking  ermo  (Section  2.20.2  libnetif). 

4 

ABADHANDLE 

Invalid  channel  handle  -  The  only  valid  handle  is  one  returned 
by  AssocOpen.  Either  AssocOpen  has  not  been  called, 
AssocOpen  failed  and  you  didnl  check  the  return  code  (!),  or 
your  application  has  somehow  corrupted  the  handle  returned 
to  it  bv  AssocOpen. 

6 

AFILEOPEN 

CoukJ  not  open  file  -  Currently,  the  only  file  that  libassoc 
opens  is  the  ‘assocDef”  file  as  passed  to  AssocQ3en.  Make 
sure  that  it  has  been  specified  correctly,  your  application  has 
permission  to  read  it.  etc. 

7 

APARM 

Invalid  parameter  -  There  is  an  error  in  the  assocDef  file.  See 
the  information  on  AssocDef  below  which  explains  how  to 
build  an  assocDef  file. 

8 

ANOMEMORY 

CoukJ  not  malloc  memory  -  If  this  error  occurs  on  startup,  the 
INITIAL_DESCRIPTORS  parameter  is  probably  too  large  for 
the  given  architecture.  If  it  occurs  at  some  later  time,  the 
ADDITIONAL_DESCRIPTORS  parameter  may  be  too  large,  or 
perhaps  descriptors  aren’t  being  freed.  Make  sure  that 
AssocTickAssocLaver  is  being  called. 

11 

AMAXSUBSCRIBED 

Maximum  subscriptions  exceeded  -  There  is  a  hard  limit  to  the 
number  of  subscriptions  allowed  by  the  network  interface,  as 
well  as  a  user-definable  imit  for  libassoc.  This  error  occurs  if 
either  is  exceeded. 

12 

APKT2BIG 

Packet  size  or  threshold  too  large  -  Either  a  request  to  send  a 
packet  larger  than  the  network  layer  will  handle,  or  in  the  case 
of  aggregated  packets,  a  threshold  size  that  is  too  large. 

Table  2.20-1  Libassoc  Errors. 
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2.20.1.1  subscribe.c 

/simnet/libsrc/libassoc/subscribe.c 

subscribe.c  contains  routines  for  subscribing  to  and  unsubscribing  from  multicast  groups. 
Table  2.20-2  describes  the  variables  used  by  subscribe.c. 


1  Variables  I 

Variable 

Where  Tvoedef  Declared 

Errno 

extern  int 

Standard  C  type. 

Table  2.20-2  subscribe.c  Variable  Information. 

2.20.1.1.1  AssocSubscribe 

AssocSubscribe  subscribes  to  a  multicast  group.  The  routine  creates  a  multicast  Ethernet 
address  from  the  group  and  protocol  parameters  and  directs  the  network  interface  to  start 
listening  to  packets  with  this  multicast  address.  No  packets  will  be  received  until  at  least 
one  multicast  address  has  been  subscribed  to.  The  ^ndle  parameter  is  a  low  integer 
referencing  the  network  channel  connection.  The  function  call  is  AssocSubscribe(handle, 
group,  protocol).  Table  2.20-3  describes  the  parameters  used,  return  values  and  possible 
errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

group 

MutticastGroupID 

/simnet/common/include/prot 
ocol/p  assoc.h 

protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

I  Errors  I 

Error  Name 

Reason  for  Error 

ANETACCESS 

Cannot  access  interface  to  the  Ethernet 

AMAXSUBSCRIBED 

Ethernet  already  has  subscribed  to  a  maximum  number  of 
multicast  addresses. 

ABADHANDLE 

Invalid  handle  (have  you  called  AssocOpenO?) 

I  Calls  I 

Function 

Where  Described 

AssocSubscribeWithMask 

Section  2.20.1.1.4. 

Table  2.20-3  AssocSubscribe  Information. 
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2.20.1.1.2  AssocUnsubscribe 

AssocUnsubscribe  unsubscribes  fiom  a  multicast  group.  The  routine  directs  the  network 
interface  to  stop  listening  to  packets  with  the  multicast  address  formed  from  the  group  and 
protocol  parameters.  The  handle  parameter  is  a  low  integer  referencing  the  network 
channel  connection.  The  function  call  is  AssocUnsubscribe(handle,  group,  protocol). 
Table  2.20-4  describes  the  parameters  used,  return  values  and  possible  errors  generated  by 
using  this  function. 


Parameters 


Parameter 


handle 


group 


protocol 


lEin 


int 


MulticastGroupIO 


AssociationUserProtocol 


Where  Tvoedet  Declared 


Standard  C  type. 


/slmnet/comnon/include/prot 
ocol/D  assoc. h 


/simnet/common/include/prot 
ocol/D  assoc.h 


Return  Value 


-1 


Type 

Meaning 

int 

Unsuccessful. 

int 

Successful. 

Error  Name 


ANETACCESS 


ABADHANDLE 


Errors 


Reason  for  Error 


Cannot  access  interface  to  the  Ethernet 


Invalid  handle  (have  you  called  AssocOpenO? 


Function 


AssocUnsubscribe  WithMask 


Calls 


Where  Described 


Section  2.21.1.1.5. 


Table  2.20>4  AssocUnsubscribe  Information. 


2.20.1.1.3  AssocCurrentlySubscribed 

AssocCumentlySubscribed  checks  to  see  if  the  application  is  currently  subscribed  to  the 
multicaste  group  address  formed  by  the  group  and  protocol  parameters.  The  handle 
parameter  is  a  low  integer  referencing  the  network  channel  connection.  The  function  call  is 
AssocCurrentlySubscribed(handle,  group,  protocol).  Table  2.20-5  describes  the 
parameters  used  and  return  values  generated  by  using  this  function. 


_  Parameters _ _ 

Parameter  I  Type  Where  Typedef  Declared 

handle _ |nt _ Standard  C  type. _ 

group  MulticastGroupIO  /simnet/common/include/prot 

_ ocol/p  assoc.h _ 

protocol  AssociationUserProtocol  /simnet/common/include/prot 

ocol/p.  assoc.h 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

1 

int 

Currently  subscribed. 

0 

int 

Not  currently  subscribed. 

Calls 

Function 

Where  Described 

AssocCurrentlySubscribed  Wit 
hMask 

Section  2.20.1.1.6. 

Table  2.20-5  AssocCurrentlySubscribed  Information. 


2.20.1.1.4  AssocSubscribeWithMask 

AssocSubscribeWithMask  subscribes  to  a  private  multicast  group  (analogous  to 
AssocSubscribe  described  above).  Reference  AssocCreatMCAWithMask()  in  Section 
2.20.1.1.8  for  a  description  of  the  mask.  The  function  call  is 
AssocSubscribeWithMask(handle,  group,  protocol,  mask).  Table  2.20-6  describes  the 
parameters  used,  return  values  and  possible  errors  generated  by  using  this  function. 


Parameter 


handle 


group 


protocol 


Parameters 


e 


int 


MulticastQroupID 


AssociationUserProtocol 


unsigned  Ion 


Where  Typedef  Declared 


Standard  C  type. 


/simnet/common/include/prot 
ocol/p  assoc,  h 


/simnet/common/include/prot 
ocol/p  assoc,  h 


Standard  C  type. 


Variable 


address 


Internal  Variables 


e 


NetworkAddress 


lEni 


Where  Typedef  Declared 


/simnet/libsrc/libnetif/network. 

h 


Return  Values 


Return  Value 


-1 


0 


Type 


int 


int 


Meaning 


Unsuccessful 


Successful. 


Errors 

Error  Name 

Reason  for  Error 

ABADHANDLE 

Invalid  handle  (have  you  called  AssocOpen(f?L 

Function 


ASSOC  CHECK  HANDLE 


AssocCreateMCAWithMask 


net  add  mca 


AddSubscription 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 


Section  2.20.1.1.7. 


Section  2.20.2.11.1. 


Section  2.20.1.1.9. 
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1  Called  Bv  1 

Function 

Where  Described 

AssocSubscribe 

Section  2.20.1.1.1. 

Table  2.20-6  AssocSubscribeWithMask  Information. 


2.20.1.1.5  AssocUnsubscribeWithMask 

AssocUnsubscribeWithMask  unsubscribes  from  a  orivate  multicast  group  (analagous  to 
AssocUnsubscribe  described  above),  group,  protc  col,  and  mask  are  used  to  specify  the 
multicast  group.  The  handle  parameter  is  a  low  iriieger  referencing  the  network  channel 
connection.  TTie  function  call  is  AssocUnsubscribeWithMask(handle,  group,  protocol, 
mask).  Table  2.20-7  describes  the  parameters  used,  return  vdues  and  possible  errors 
generated  by  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

group 

MulticastGroupID 

/simnet/common/include/prot 
ocol/p  assoc.h 

protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc.h 

Standard  C  tvoe. 


Variable 


address 


Internal  Variables 


e 


NetworkAddress 


lElT! 


Where  Tvbedef  Declared 


/simnet/libsrc/libnetif/network. 

h 


Return  Values 


Return  Value 


-1 


Type 


mt 


int 


Meaning 


Unsuccessful. 


Successful. 


Error  Name 


ABADHANDLE 


Errors 


Reason  for  Error 


Invalid  handle  (have  you  called  AssocOpenO? 


Function 


ASSOC  CHECK  HANDLE 


AssocCreateMCAWithMask 


net  del  mca 


DeleteSubsciotion 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 


Section  2.20.1.1.7. 


Section  2.20.2.11.2. 


Section  2.20.1.1.10. 


Function 


AssocUnsubscribe 


AssocClose 


Called  B 


Where  Described 


Section  2.20.1.1.2. 


Section  2.20.1.11.1. 


Table  2.20-7  AssocUnsubscribeWithMask  Information. 
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2.20.1.1.6  AssocCurrentlySubscribedWithMask 


AssocCurrentlySubscribedWithMask  checks  to  see  if  the  application  is  currently  subscribed 
to  a  given  private  multicast  group  (analogous  to  AssocCurrentlySubscribed  described 
above),  group,  protocol,  and  mask  are  used  to  specify  the  multicast  group.  The  function 
call  is  AssocCurrentlySubscribedWithMask(handle,  ^up,  protocol,  mask).  Table  2.20-8 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

handle 

int 

Standard  C  type. 

group 

MulticastGi’OupID 

/simnet/common/include/prot 
ocol/p  assoc. h 

protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc. h 

mask 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

i 

register  int 

Standard  C  type. 

subCount 

register  int 

Standard  C  type. 

s 

register  pointer  to 

Subscription 

/simnet/libsrc/libassoc/assocj 

cl.h 

channel 

register  pointer  to 
ChannelDescriptor 

/simnel/libsrc/libassoc/assoc_l 

cl.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

1  Errors  1 

Error  Name 

Reason  for  Error 

ABADHANDLE 

Invalid  handle  (have  you  called  AssocOpenO?). 

1  Calls  1 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h, 

1  Called  By  1 

Function 

Where  Described 

AssocCurrentlySubscribed 

Section  2.20.1.1.3. 

Table  2.20-8  AssocCurrentlySubscribedWithMask  Information. 
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2.20.1.1.7  AssocCreateMCA 

AssocCreateMCA  creates  the  Multicast  Group  Address  in  the  buffer  pointed  to  by  address 
using  the  group  and  protocol  parameters  as  described  in  AssocCreateMCA  WithMask  using 
a  mask  of  zero.  The  function  call  is  AssocCrcateMCAWithMask(group,  protocol,  address, 
mask).  Table  2.20-9  describes  the  parameters  used,  return  values  and  possible  errors 
generated  by  using  this  function. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

group 

MulticastGroupIO 

/simnet/common/include/prot 
ocol/p  assoc. h 

protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc. h 

mask 

unsianed  Iona 

Standard  C  type. 

address 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

1  Calls  1 

Function 

Where  Described 

AssocCreateMCAWithMask 

Section  2.20.1.1.7. 

Table  2.20-9  AssocCreateMCA  Information. 

2.20.1.1.8  AssocCreateMCA  WithMask 

AssocCreateMCAWithMask  creates  a  multicast  group  address  using  group,  protocol  and 
mask  as  follows: 

Because  bits  are  transmitted  from  lowest  addressed  bit  to  highest  addressed  bit,  a 
NetworkAddress  looks  like  this: 

17  654321  0  115  1413  1211  1098  1232221  20  19  18  17  16  131  30  29  28  27  26  25  etc.  I 

Bit  0  gets  a  1,  bit  1  gets  a  1,  bits  2->7  get  Os,  bits  8->31  get  bits  0->23  of  the  mask,  bits 
32->39  get  the  group  number,  and  bits  40->47  get  the  protocol  number.  This  functionality 
is  considered  an  extension  to,  rather  than  a  part  of,  the  association  layer. 

The  function  call  is  AssocCreateMCA(group,  protocol,  mask,  address).  Table  2.20-10 
describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

group 

MulticastGroupIO 

/simnet/comrrwn/include/prot 
ocol/p  assoc. h 

protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc. h 

address 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetit/network. 

h 

mask 

Standard  C  type. 

1  1 
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Variable 


addr 


Internal  Variables 


reoister  pointer  to  char 


Where  Typedef  Declared 


Standard  C  type. 


Return  Value 


-1 


Return  Values 


Meanin 


Unsuccessful. 


Successful. 


Error  Name 


ABADHANDLE 


Errors 


Reason  for  Error 


Invalid  handle  (have  you  called  Assoc 


Called  B 


Function  Where  Described 


AssocSubscribeWithMask  Section  2.20.1 .1 .4. 


AssocUnsubscribeWithMask  Section  2.20.1.1.5. 


AssocCreateMCA  Section  2.20.1.1.8. 


AssocSendDataaram  Section  2.20.1.2.1. 


AssocSendAoareaate  Section  2.20.1.3.1. 


AssocSendTransact  Section  2.20.1.4.1. 


AssocSendResponse  Section  2.20.1.4.2. 


Table  2.20-10  AssocCreateMCA  Information. 

2.20.1.1.9  AddSubscription 

AddSubscription  is  called  by  the  routine  AssocSubscribe  to  add  a  subscription  to  a 
multicast  group.  The  function  call  is  AddSubscription(handle,  group,  protocol,  mask). 
Table  2.2^1 1  describes  the  parameters  used  and  errors  returned  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

group 

MulticastGroupID 

/simnet/common/include/prot 
ocol/p  assoc. h 

protocol 

AssociationUserProtocol 

/simnet/common/inciude/prot 
ocol/p  assoc, h 

Variable 


channel 


subscriptions 


Standard  C  type. 


Internal  Variables 


e 


register  pointer  to 
ChannelDescriptor 


register  pointer  to 
Subscription 


Where  Typedef  Declared 


/simnet/libsrc/libassoc/assocj 

cl.h 


/simnet/libsrc/libassoc/assoc_,l 

cl.h 


Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 
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1  Errors  1 

Error  Name 

Reason  for  Error 

AMAXSUBSCRIBED 

Ethernet  already  has  subscribed  to  a  maximum  number  of 
multicast  addresses. 

Called  Bv 

Function 

Where  Described  I 

AssocSubscribeWithMask 

Section  2.20.1.1.4.  1 

Table  2.20*11  AddSubscription  Information. 


2.20.1.1.10  DeleteSubscription 

DeleteSubscription  is  called  by  the  routine  AssocUnsubscribe  in  order  to  remove  a 
subscription  to  a  multicast  group.  The  function  call  is  DeleteSubscription(handle,  group, 
protocol,  mask).  Table  2.20-12  describes  the  parameters  used,  errors  returned  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

handle 

int 

Standard  C  type. 

group 

MutticastGroupID 

/simnet/common/include/prot 
ocol/p  assoc,  h 

protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc. h 

mask 

unsigned  long 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Tvoedef  Declared 

i 

register  int 

Standard  C  type. 

subCount 

register  int 

Standard  C  type. 

channel 

register  pointer  to 
ChannelDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

s 

register  pointer  to 

Subscription 

/simnet/libsrc/libassoc/assocj 

cl.h 

1  Called  Bv  1 

Function 

Where  Described 

AssocUnsubscribe  WithMask 

Section  2.20.1.1.5. 

Table  2.20*12  DeleteSubscription  Information. 


2.20.1.2  send.c 

/simnet/libsrc/libassoc/send.c 

send.c  contains  routines  for  sending  datagrams.  Table  2.20-13  describes  the  variables 
used  by  send.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

outBuf 

AssocNetBuffer 

/simnet/libsrc/libassoc/assoc_l 

cl.h 

Table  2.20-13  send.c  Variable  Information. 
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2.20.1.2.1  AssocSendDatagram 

AssocSendDatagram  sends  an  Association  Datagram  to  the  multicast  group  defined  by 
group  and  protocol,  and  current  send  mask,  data  points  to  the  data  to  be  contained  in  the 
datagram,  length  is  the  number  of  bytes  pointed  to  by  data .  The  function  call  is 
AssocSendDatagram(handle,  data,  length,  group,  protocol).  Table  2.20-14  describes  the 
parameters  used,  return  values  and  possible  errors  generate  by  using  this  function. 


Parameters 


Parameter 


handle 


data 


lenath 


group 


protocol 


MulticastQroupID 


AssodationUserProtocol 


Where  Tyoedef  Declared 


Standard  C  tvoe. 


Standard  C  t 


Standard  C  type. 


/simnet/common/include/prot 
ocol/D  assoc. h 


/simnet/common/include/prot 
ocol/p  assoc. h 


Variable 


apdu 


daSize 


addrStrin 


Internal  Variables 


register  pointer  to 
AssociationPDU 


int 


char 


Where  Tvoedef  Declared 


/simnet/common/include/prot 
ocol/p  assoc. h 


Standard  C  type. 


Standard  C  type. 


Return  Value 


Return  Values 


Meanin 


Unsuccessful. 


Successful. 


Errors 

Error  Name 

Reason  for  Error 

ANETACCESS 

Cannot  access  interface  to  the  Ethernet 

Calls 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h 

CHECK  ASSOC  PKT  LENG 
TH 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

AssocCreateMCAWithMask 

Section  2.20.1.1.7. 

DATACOPY 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

PRO  ASSOC  DATAGRAM 
SIZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

CHECK  NET  PKT  LENGTH 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h 

AssocPadBuffer 

Section  2.20.1.2.2. 

net  snd 

Section  2.20.2.19.2. 

Table  2.20-14  AssocSendDatagram  Information. 
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2.20.1.2.2  AssocPadBuffer 

AssocPadBuffer  expects  a  pointer  to  the  beginning  of  a  data  buffer  aPDU  and  the  current 
length  of  the  buffer.  It  adds  a  padding  PDU  to  the  end  of  the  PDU  in  order  to  bring  the 
tot^  size  up  to  MIN_DATA_SIZE_8023.  The  function  call  is  AssocPadBuffer(apdu, 
bufferLength),  Table  2.20-15  describes  the  parameters  used  and  functions  called  using  this 
funcdon. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

apdu 

pointer  to  AssodationPDU 

/simnet/common/include/prot 
ocol/p  assoc. h 

bufferLength 

pointer  to  int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

padding 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DATACOPY 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

PRO  ASSOC  PADDING  HD 
R  SIZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

PRO  ASSOC  PADDING  SI2 
E 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

1  Called  Bv  1 

Function 

Where  Described 

AssocSendDatagram 

Section  2.20.1.2.1. 

AssocSendAggregate 

Section  2.20.1.3.1. 

AssocSendT  ransact 

Section  2.20.1.4.1. 

AssocSendResponse 

Section  2.20.1.4.2. 

Table  2.20-15  AssocPadBuffer  Information. 

2.20.1.3  aggregate.c 

/simnet/libsrc/libassoc/aggregate.c 

aggregate.c  contains  routines  for  sending  aggregated  datagrams. 

2.20.1.3.1  AssocSendAggregate 

AssocSendAggregate  adds  this  PDU  to  a  buffer  of  PDUs  of  the  same  group  and  protocol. 
If  the  current  buffer  of  PDUs  has  a  different  group  or  protocol,  or  if  the  current  send  mask 
has  changed,  that  buffer  is  written  to  the  net  and  a  new  buffer  is  filled  with  the  current 
PDU.  data  is  a  pointer  to  the  current  PDU  to  be  sent  and  length  is  the  number  of  bytes 
pointed  to  by  data,  timer  is  the  number  of  milliseconds  the  PDU  can  wait  before  being 
sent  threshold  is  the  maximum  number  of  bytes  allowed  in  the  aggregated  packet.  To 
send  a  PDU  out  immediately  and  thus  flush  the  current  buffer,  set  threshold  to  0. 
Aggregate  PDUs  are  sent  to  the  multicast  group  formed  by  the  group  and  protocol  common 
to  all  of  the  PDUs  in  the  buffer  and  the  send  mask  in  force  while  it  was  built.  The  function 
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call  is  AssocSendAggregate(handle,  data,  length,  group,  protocol,  timer,  threshold).  Table 
2.20-16  describes  the  parameters  us^,  return  values  and  possible  errors  generated  by 
using  this  function. 


Parameter 


handle 


data 


lenoth 


group 


protocol 


timer 


threshold 


Variable 


channel 


currentTime 


destAddr 


Return  Value 


-1 


Parameters 


MulticastGroupIO 


AssociationUserProtocol 


unsioned  Iona  int 


unsioned  long  int 


Where  Tvpedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


/simnet/common/include/prot 
ocol/D  assoc.h 


/simnet/common/include/prot 
ocol/D  assoc.h 


Standard  C  t 


Standard  C  t 


Internal  Variables 


e 


register  pointer  to 
ChannelOescriptor 


register  pointer  to 
AssociationPDU 


NetworkAddress 


Where  Tvoedef  Declared 


/simnet/libsrc/libassoc/assocj 

cl.h 


/simnet/common/include/prot 
ocol/D  assoc.h 


Standard  C  tvoe. 


/simnet/libsrc/libnetif/network. 

h 


Return  Values 


Meanin 


Unsuccessful. 


Successful. 


Error  Name 


ANETACCESS 


Errors 


Reason  for  Error 


Cannot  access  interface  to  the  Ethernet 


Calls 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

CHECK  ASSOC  PKT  LENG 
TH 

Macro  defined  in  /simnet/libsrc/libassoc/assoc„lcl.h. 

CHECK  NET  PKT  LENGTH 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl  h. 

net  current  time 

Section  2.20.2.8.3. 

AssocCreateMCAWithMask 

Section  2.20.1.1.7. 

AssocPadBuffer 

Section  2.20.1.2.2. 

net  snd 

Section  2.20.2.19.2. 

MIN 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

DATACOPY 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

PRO  ASSOC  DATAGRAM 
SIZE 

Macro  defined  in  /simnet/common/include/protocol/p^si^e  h 
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1  Called  Bv  1 

Function 

Where  Described 

AssocTickAssocLaver 

Section  2.20.1.8.1. 

Table  2.20-16  AssocSendAggregate  Information. 

2.20.1.4  transact.c 

/simnet/libsrc/libassocAransactc 

transacLc  contains  routines  to  interface  the  host  to  the  transaction  protocol  capabilities  of 
the  association  layer  library. 

2.20.1.4.1  AssocSendTransact 


AssocSendTransact  sends  an  Association  Transaction  PDU  directed  to  respondent  and 
visible  to  any  other  observer  subscribed  to  the  Ethernet  multicast  address  described  by  the 
group  and  protocol  pair,  in  conjunction  with  the  current  send  mask,  respondent  must  also 
be  subscribed  to  this  multicast  ^dress.  data  points  to  the  data  to  be  transmitted  and  length 
is  the  number  of  bytes  in  data. 


If  a  response  to  this  transaction  is  received,  the  callback  routine  will  be  called  with  the  user- 
specified  cparam  as  one  of  its  parameters.  If  the  transaction  times  out  before  a  response  is 
received,  the  timeout  routine  will  be  called  with  the  used-specified  tparam  as  one  of  its 
parameters.  Note  that  cparam  and  tparam  must  point  to  space  that  is  statically  allocated  by 
the  application.  When  a  response  is  received,  the  application  is  notified  via  the  primitive 
parameter  to  the  AssocReceivePDU  routine.  No  such  notification  is  given  in  the  case  of 
timeout,  however. 


The  callback  routine  should  be  defined  by  the  application  as: 


int  callback(data,  length,  respondent,  cparam) 
char  data; 
long  int  length; 

SimulationAddress  respondent; 
long  int  cparam; 

where  respondent  is  the  Simulation  Address  of  the  simulator  which  has  responded  to  the 
transaction,  length  is  the  number  of  bytes  in  the  information  pointed  to  by  ^la.  cparam  is 
a  user  supplied  parameter  which  may  be  used  to  store  extra  information  for  the  transaction, 
cparam  must  point  to  storage  which  is  allocated  by  the  application. 


The  timeout  routine  should  be  defined  by  the  application  as: 


int  timeout(data,  length,  respondent,  tparam) 
char  data; 
long  int  length; 

SimulationAddress  respondent; 
long  int  tparam; 
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where  respondent  is  the  Simulation  Address  of  the  simulator  who  was  supposed  to  respond 
to  the  transaction,  length  is  the  number  of  bytes  in  the  information  pointed  to  by  data, 
which  is  the  miginal  PDU  sent  by  the  q)plication.  tparam  is  a  user  supplied  parameter 
which  may  be  used  to  sttve  extra  infoimation  fra*  the  transacticm.  Again,  tparam  must  point 
to  storage  which  is  allocated  by  the  application. 

The  function  call  is  AssocSendTransact(handle,  data,  length,  group,  protocol,  respondent, 
callback,  cparam,  timeout,  tparam).  Table  2.20-17  describes  ^e  parameters  used,  return 
values  and  possible  errors  generated  by  using  this  function. 
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Function 


ASSOC  CHECK  HANDLE 


AssocGetDescriDtor 


AssocCreateMCAWithMask 


DATACOPY 


PRO_ASSOC_REQUEST_SI 

ZE 


AssocPadBuffer 


net  snd 


AssocFreeDescriptor 


AssocAddT  ransaction 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 


Section  2.20.1.24.3. 


Section  2.20.1.1.7. 


Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 


Macro  defined  in  /simnet/common/include/protocol/p_size.h 


Section  2.20.1.2.2. 


Section  2.20.2.19.2. 


Section  2.20.1.24.4. 


Section  2.20.1.23.2. 


Table  2.20*17  AssocSendTransact  Information. 

2.20.1.4.2  AssocSendResponse 

AssocSendResponse  sends  an  Association  Response  PDU  directed  to  the  originator  of  the 
transaction.  Any  observers  subscribed  to  the  Ethernet  multicast  address  described  by  the 
same  group,  protocol  and  send  mask  as  the  transaction  can  also  listen  to  the  response. 
Note  that  the  send  mask  of  the  last  transaction  received  is  used  for  the  response,  not  the 
current  send  mask  of  the  respondee.  This  behavior  may  be  modified  by  using 
AssocSetRspMask.  cache  response  should  be  TRUE  if  the  association  entity  should 
respond  to  subsequent  retries  with  the  same  response,  cache  response  should  be  FALSE 
if  the  application  wishes  to  hear  each  retry,  data  points  to  the  data  in  the  response  and 
length  is  the  number  of  bytes  pointed  to  by  data .  transID  must  be  the  same  transID  as  the 
original  request.  The  function  call  is  AssocSendResponse(handle,  data,  length,  group, 
protocol,originator,  transID,  cache_response).  Table  2.20-18  describes  the  parameters 
used,  return  values  and  possible  errors  generated  by  using  this  function. 


Parameter 


handle 


data 


lenath 


group 


protocol 


oriqinator 


transID 


cache  response 


Parameters 


e 


int 


inter  to  char 


lonq  int 


MulticastGroupID 


AssociationUserProtocol 


inter  to  SimAddress 


T  ransactionidentifier 


lonq  int 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


/simnet/common/mclude/prot 
ocol/p  assoc. h 


/simnet/common/include/prot 
ocol/p  assoc.h 


/si  mnet/comnw  n/i  nclude/prot 
ocol/address.h 


Standard  C  type. 


Internal  Variables 

Variable 

Where  Typedef  Declared 

rd 

register  pointer  to 
AssocTransDescriptor 

/simnet/libs'fc  libassoc/assoc_l 
cl.h 

apdu 

register  pointer  to 
AssociationPDU 

/simnet/cominon/include/prot 
ocol/p  assoc.h 

rspSize 


Standard  C  t 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

ANETACCESS 

Cannot  access  interface  to  the  Ethernet 

ANOM EMORY 

Not  enough  memory  for  internal  Association  structures 

Calls 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

AssocGetDescriptor 

Section  2.20.1.24.3. 

AssocCreateMCAWithMask 

Section  2.20.1.1.7. 

DATACOPY 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

PRO  ASSOC  RESPONSE 
SIZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

AssoePadBuffer 

Section  2.20.1.2.2. 

net  snd 

Section  2.20.2.19.2. 

AssocFreeDescriptor 

Section  2.20.1.24.4. 

AssocCacheResponse 

Section  2.20.1.18.2 

Table  2.20-18  AssocSendResponse  Information. 

2.20.1.5  open.c 

/simnet/libsrc/libassoc/open.c 

open.c  contains  routines  to  initialize  the  association  layer.  Table  2.20-19  describes  the 
variables  used  by  open.c. 


1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

errno 

extern  int 

Standard  C  type. 

channelMap 

pointer  to  array  size 
maxChannels  of 
ChannelDescriptor 

/simnet/libsrc/libassoc/assoc  1 
cl.h 

assocPaddingPDU 

AssociationPDU 

/simnet/common/include/prot 
ocol/p  assoc. h 

Table  2.20-19  open.c  Variable  Information. 

2.20.1.5.1  AssocOpen 

AssocOpen  resets  the  network  interface  and  opens  a  channel  to  the  specified  network.  It 
allocates  and  initializes  all  data  structures  and  variables  needed  by  the  association  network 
entity,  device  is  the  name  of  the  device  you  wish  to  open  (e.g.  “/dev/enpO”)  assocDef  is 
the  name  of  the  file  to  use  for  association  layer  definitions/parameters.  AssocOpen  resets 
the  network  interface  to  insure  that  the  device  is  not  in  promiscuous  mode,  that  no  multicast 
groups  are  currently  subscribed  to,  that  the  ethemet  type  code  (AssocFamily)  is  set  to  the 
default,  and  that  the  input  and  output  buffers  are  flushed.  A  number  of  defaults  for  the 
channel  are  set.  Some  of  these  defaults  are  modifiable  by  etitries  in  the  assfx  Def  file. 
AssocDef  parameters  are  described  in  Table  2.20-80. 
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This  routine  returns  a  handle  to  a  network  interface  that  must  be  used  for  subsequent 
association  library  calls,  and  may  be  used  directly  for  network  Oibne^  calls.  Either 
AssocOpen  or  AssocAttach  must  be  called  before  any  other  association  routine  is  called. 
The  function  call  is  AssocOpen(device,  assocDef).  Table  2.20-20  describes  the  parameters 
used,  return  values  and  possible  errors  generated  by  using  this  function. 


Parameters 


Parameter 


device 


assocDef 


Variable 


handle 


nib 


irs 

irs 


ieit: 


Where  Tvoedef  Declared 


inter  to  char 

Standard  C  t 

inter  to  char 

Standard  C  t 

Internal  Variables 


e 


struct  net  info  block 


Where  Typedef  Declared 


Standard  C  type. 


/simnet/libsrc/libnetif/network. 

h 


Return  Values 


Return  Value  Type 


-1  int 


association  channel  (and  net)  int 
handle 


Meaning 


Unsuccessful. 


Successful. 


Error  Name 


ANETOPEN 


ANETACCESS 


ANOM EMORY 


AFILEOPEN 


APARM 


Errors 


Reason  for  Error 


Cannot  open  interface  to  the  Ethernet. 


Cannot  initialize  multicast  service  or  device  does  not  respond. 


Cannot  malloc  memory  for  transaction  service  data  staictures. 


Cannot  open  the  assocDef  file. 


Missing  or  invalid  site  and/or  hose  parameter  is  assocDef  file. 


Calls 


Function  Where  Described 


net  open  Section  2.20.2.10.1. 


net  stop  Section  2.20.2.13.2. 


net  norm  Section  2.20.2.7.1. 


net  alive  Section  2.20.2.1.1. 


net  init  mca  Section  2.20.2.11.3. 


SetChannelDefaults  Section  2.20.1.5.3. 


AssocReadParams  Section  2.20.1.22.2. 


net  init  type  Section  2.20.2.18.2. 


net  add  type  Section  2.20.2.18.1. 


net  set  snd  type  Section  2.20.2.19.8. 


net  set  snd  from  addr  Section  2.20.2.19.7. 


AssocCreateFreeList  Section  2.20.1.24.1. 


AssocInitTransactions  Section  2.20.1.23.1. 


AssocInitResoonses  I  Section  2.20.1.18.1. 


Table  2.20-20  AssocOpen  Information. 
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2.20.1.5.2  AssocAttach 

AssocAttach  opens  a  channel  to  a  network  device  without  resetting  the  network  interface. 

It  should  be  called  if  some  other  process  has  already  called  AssocOpen.  Either  AssocC^n 
or  AssocAttach  must  be  called  before  any  odKr  association  routine  is  called.  The  function 
call  is  AssocAttach(device,  assocDef).  Table  2.20-21  describes  the  parameters  used,  return 
values  and  possible  errors  generated  by  using  this  function. 


Parameters 


Parameter 


device 


assocDef 


Variable 


handle 


nib 


IE27? 

\n 
irs 


inter  to  char 


inter  to  char 


IDT! 


Internal  Variables 


e 


struct  net  info  block 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  tvoe. 


Where  Typedef  Declared 


Standard  C  type. 


/simnet/libsrc/'ibnetif/network. 

h 


Return  Values 


Return  Value 


association  channel  (and  net) 
handle 


Meanin 


Unsuccessful. 


Successful. 


Error  Name 


ANETOPEN 


ANETACCESS 


ANOMEMORY 


AFILEOPEN 


APARM 


Errors 


Reason  for  Error 


Cannot  open  interface  to  the  Ethernet. 


Cannot  initialize  multicast  service  or  device  does  not  respond. 


Cannot  malloc  memory  for  transaction  service  data  structures. 


Cannot  open  the  assocDef  file. 


Missino  or  Invalid  site  and/or  hose  parameter  is  assocDef  file. 


Calls 


Function  Where  Described 


net  open  Section  2.20.2.10.1. 


net  alive  Section  2.20.2.1.1. 


SetChannelDefaults  Section  2.20.1.5.3. 


AssocReadParams  Section  2.20.1.22.2. 


net  add  tvoe  Section  2.20.2.18.1. 


net  set  snd  from  addr  Section  2.20.2.19.7. 


AssocCreateFreeList  Section  2.20.1.24.1. 


AssocInitTransactions  Section  2.20.1.23.1. 


AssocInitResoonses  I  Section  2.20.1.18.1. 


Table  2.20-21  AssocAttach  Information. 
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2.20.1.5.3  SetChannelDefaults 

SetChannelDefaults  sets  the  channel  parameters  to  the  default  values.  The  function  call  is 
SetChannelDefaults(handle).  Table  2.20-22  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Where  Tvoedef  Declared 

handle 

int 

standard 

Internal  Variables 

Variable 

Where  Typedef  Declared 

channel 

register  pointer  to 
ChannelDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

1  Called  Bv  1 

Function 

Where  Described 

AssocAttach 

Section  2.20.1.5.2. 

AssocOpen 

Section  2.20.1.5.1. 

Table  2.20*22  SetChannelDefaults  Information. 

2.20.1.6  receive. c 

/simnet/libsrc/libassoc/receive.c 

receive.c  contains  routines  to  receive  packets  for  the  SIMNET  network  through  the 
association  layer.  Table  2.20-23  describes  the  variables  used  by  receive.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

errno 

extern  int 

Standard  C  type. 

Table  2.20-23  receive.c  Variable  Information. 

2.20.1.6.1  AssocReceivcPDU 

AssocReceivePDU  queries  the  Association  Layer  for  PDU’s  firom  the  network.  The 
routine  gets  a  pointer  to  the  next  PDU  and  sets  what  the  data  pointer  {*data)  to  the  PDU 
pointer  when  appropriate.  The  data  pointer  will  not  be  set  if  the  PDU  is  a  response  to  a 
transaction  the  application  issued  or  if  the  PDU  is  a  retry  for  which  the  application  has  a 
response  cached.  If  the  PDU  is  a  response  to  a  transaction  the  application  issued,  the 
association  entity  calls  the  supplied  callback  routine  and  returns  with  primitive  equal  to 
ASSC)C_TRANSACT_CONTF.  If  the  PDU  is  a  retry  request  for  which  the  application  has 
a  cached  response,  the  association  entity  retransmits  the  response  and  returns  with  primitive 
equal  to  ASSCX!_NOTHING_OF_INTCREST.  When  AssocReceivePDU  returns  a  PDU, 
protocol  is  the  user  protocol  to  which  the  PDU  belongs,  and  primitive  indicates  whether  the 
PDU  is  a  datagram,  request,  etc.,  as  defined  in  “assoc.h”.  length  is  the  number  of  bytes  in 
the  information  pointed  to  by  data.  The  function  call  is  AssocReceivePDU (handle,  data, 
length,  group,  protocol,  primitive,  originator,  transID,  respondent).  Table  2.20-24 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 
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Parameter 


handle 


data 


lenath 


group 


protocol 


rimitive 


originator 


transID 


respondent 


Parameters 


e 


int 


inter  to  pointer  to  char 


inter  to  Iona  int 


pointer  to  MulticastGroupID 


pointer  to 

AssociationUserProtocol 


inter  to  Iona  int 


pointer  to  SimuiationAddress 


pointer  to  Transactionidentifier 


pointer  to  SimuiationAddress 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


/simnet/common/include/prot 
ocol/p  assoc. h 


/simnet/common/include/prot 
ocol/p  assoc.h 


Standard  C  type. 


/simnet/common/include/prot 
oco  I/address,  h 


/simnet/common/include/prot 

ocol/address.h 


/simnet/common/include/prot 

ocol/address.h 


Variable 


channel 


inBuf 


retval 


apduSize 


Internal  Variables 


e 


register  pointer  to 
ChannelDescriptor 


/egister  pointer  to 
AssociationPDU 


inter  to  char 


int 


int 


Where  Typedef  Declared 


/simnet/libsrc/libassoc/assocj 

cl.h 


/simnet/common/include/prot 
ocol/p  assoc.h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Read  failed. 

0 

int 

Data  is  returned. 

1 

int 

No  data  is  returned  and 
network  buffers  are  not  empty. 

2 

int 

Network  buffers  are  empty. 

Error  Name 


ANETACCESS 


Errors 


Reason  for  Error 


Cannot  access  interface  to  the  Ethernet. 
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1  Calls  1 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Ici.h. 

net  release  rev 

Section  2.20.2.17.10. 

net  qet  rev 

Section  2.20.2.17.9. 

REJECT  PACKET 

Macro  defined  in  receive.c.  Section  2.20.1.6. 

PROCESS  DATAGRAM  PD 

U 

Macro  defined  in  /simnet/libsrc/libassoc/assoc_lcl.h. 

PRO  ASSOC  DATAGRAM 
SIZE 

Macro  defined  in  /simnet/comnf)on/include/protocol/p_size.h 

AssoeProeessReauestPDU 

Section  2.20.1.20.1. 

PRO  ASSOC  REQUEST  SI 
ZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

AssoeProeessResponsePDU 

Section  2.20.1.19.1. 

PRO  ASSOC  RESPONSE 
SIZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

PRO  ASSOC  PADDING  SIZ 
E 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

Table  2.20-24  AssocReceivePDU  Information. 


Table  2.20-25  lists  the  values  returned  in  primitive. 


Value 

Description 

ASSOC_NOTHING_OFJNTEREST 

Padding  PDU  or  Association  Layer  retransmitted  a 
cached  response. 

ASSOC  DATAGRAM  IND 

Datagram  PDU. 

ASSOC  REQUEST  IND 

Transaction  request  to  which  we  are  an  observer. 

ASSOC  RESPONSE  IND 

Transaction  response  to  which  we  are  an  observer. 

ASSOC  TRANSACT  IND 

Transaction  request  destined  for  my  host. 

ASSOC  TRANSACT  CONF 

Association  layer  process  a  callback  routine. 

Table  2.20-25  Values  Returned  in  Primitive  of  AssocReceivePDU. 


2.20.1.7  block. c 

/simnet/libsrc/libassoc/block.c 


block.c  contains  routines  to  receive  packets  from  the  SIMNET  network  through  the 
association  layer.  It  differs  from  receive.c  (Section  2.20.1.6.)  in  that  calls  to 
AssocWaitForPDU  block  on  the  network. 
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2.20.1.7.1  AssocWaitForPDU 

AssocWaitForPDU  queries  the  Association  Layer  for  PDUs  from  the  net,  reads  the 
Association  PDU,  and  sets  *data  to  the  address  of  the  PDU.  AssocWaitForPDU  will  block 
until  a  packet  is  received  frwn  the  network.  The  packet  is  then  processed  in  the  same 
manner  as  in  Section  2.20. 1.6.1  AssocReceivePDU,  except  that  if  there  is  no  data  to  be 
returned  to  the  application  frxxn  that  packet,  the  routine  again  blocks  on  the  network,  until 
there  is  a  PDU  to  return.  The  function  call  is  AssocWaitFOTPDU(handle,  data,  length, 
group,  protocol,  primitive,  originator,  transID,  respondent).  Table  2.20-26  describes  the 
parameters  used,  return  values  and  possible  errors  generate  by  using  this  function. 


Parameter 


handle 


data 


lenath 


group 


protocol 


rimitive 


originator 


transID 


respondent 


Variable 


channel 


inBuf 


needAPDU 


retVal 


apduSize 


Parameters 


inter  to  pointer  to  char 


inter  to  long  int 


pointer  to  MutticastGroupID 


pointer  to 

AssociationUserProtocol 


inter  to  Iona  int 


pointer  to  SimulationAddress 


pointer  to  Transactionidentifier 


pointer  to  SimulationAddress 


Internal  Variables 


e 


register  pointer  to 
ChannelDescriptor 


register  pointer  to 
AssociationPDU 


inter  to  char 


int 


int 


int 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  tvoe. 


Standard  C  t 


/simnet/common/mclude/prot 
ocol/D  assoc.h 


/simnet/common/include/prot 
ocol/D  assoc.h 


Standard  C  tvoe. 


/simnet/common/include/prot 
oco  I/address. h 


/simnet/common/include/prot 

ocol/address.h 


/simnet/common/include/prot 

ocol/address.h 


Where  Tvpedef  Declared 


/simnet/libsrc/libassoc/assoc_l 

cl.h 


/simnet/common/include/prot 
ocol/p  assoc.h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Return  Value 


-1 


Type 

Meaning 

int 

Read  failed. 

int 

Data  is  returned. 

Error  Name 


ANETACCESS 


Errors 


Reason  for  Error 


Cannot  access  interface  to  the  Ethernet. 
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1  Calls  1 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

net  release  rev 

Section  2.20.2.17.10. 

net  aet  rev 

Section  2.20.2.17.9. 

REJECT  PACKET 

Macro  defined  in  btock.c.  Section  2.20.1 .7. 

PROCESS  DATAGRAM  PD 

U 

Macro  defined  in  /slmnet/Nbsrc/libassoc/assoc_lcl.h. 

PRO  ASSOC  DATAGRAM 
SIZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

AssocProcessRequestPDU 

Section  2.20.1.20.1. 

PRO  ASSOC  REQUEST  SI 
ZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

AssocProcessResDonsePDU 

Section  2.20.1.19.1. 

PRO  ASSOC  RESPONSE 
SIZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

PRO  ASSOC  PADDING  SIZ 
E 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

Table  2.20-26  AssocWaitForPDU  Information. 


Table  2.20-27  lists  the  values  returned  in  primitive. 


Value 

Description 

ASSOC  DATAGRAM  IND 

Dataqram  PDU. 

ASSOC  REQUEST  IND 

Transaction  request  to  which  we  are  an  observer. 

ASSOC  RESPONSE  IND 

Transaction  response  to  which  we  are  an  obsen/er. 

ASSOC  TRANSACT  IND 

Transaction  request  destined  for  my  host. 

Table  2.20-27  Values  Returned  in  Primitive  of  AssocWaitForPDU. 

2.20.1.8  tick.c 

/simnet/libsrc/libassoc/tick.c 

tick.c  contains  routines  which  perform  time  related  functions  of  the  Association  service. 

2.20.1.8.1  AssocTickAssocLayer 

AssocTickAssocLayer  performs  time-related  functions  of  the  Association  service.  It  will 
issue  retries  for  those  Association  Transactions  that  have  not  yet  received  a  response  and 
calls  a  callback  routine  for  those  transactions  that  have  timed  out  to  indicate  a  failed 
transaction.  The  callback  routine  is  the  one  that  was  specified  in  the  initial  call  to 
AssocSendTransact().  If  no  callback  routine  was  supplied,  the  transaction  is  simply 
cleared.  It  will  clear  cached  responses  that  have  tim^  out  and  send  out  expired  aggregate 
packets.  AssocTickAssocLayer  must  be  called  by  the  application  in  order  to  perform  tiiese 
activities  and  should  be  called  at  least  once  a  second  to  conform  to  the  SIMNET  6.0 
protocol.  AssocTickAssocLayer  replaces  AssocUpdateTransactions.  The  function  call  is 
AssocTickAssocLayer(handle).  Table  2.20-28  describes  the  parameters  used,  return 
values  and  possible  errors  generated  by  using  this  function. 
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Parameter 


handle 


Parameters 


Variable 


channel 


Internal  Variables 


e 


register  pointer  to 
ChannelDescriptor 


MCC  CSCI 


Where  Tvpedef  Declared 


Standard  C  t 


Where  Tvpedef  Declared 


/simnet/libsrc/libassoc/assocj 

cl.h 


Return  Values 


Return  Value 


-1 


Meaning 


Unsuccessful. 


Successful. 


Error  Name 


ANETACCESS 


Errors 


Reason  for  Error 


Cannot  access  Ethernet  interface. 


Function 


ASSOC  CHECK  HANDLE 


AssocTimeOutOldResoonse 


UpdateT  ransactions 


net  current  time 


AssocSendAqqreqate 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 


Section  2.20.1.18.4. 


Section  2.20.1.8.2. 


Section  2.20.2.8.3. 


Section  2.20.1.3.1. 


Table  2.20-28  AssocTickAssocLayer  Information. 
2.20.1.8.2  UpdateTransactions 

UpdateTransactions  is  called  by  AssocTickAssocLayer  in  order  to  retry  transactions  and 
time  out  old  cached  responses.  The  function  call  is  IJpdateTransactions(handle).  Table 
2.20-29  describes  the  parameters  used,  errors  returned  and  functions  called  using  this 
function. 


Parameters 


Parameter 


handle 


Where  Tvoedef  Declared 


Standard  C  tvpe. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

ti 

register  pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

channel 

register  pointer  to 
ChannelDescriptor 

/simnet/libsrc/libassoc/assocJ 

cl.h 

next 

pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 
cl  i: 

currentTicks 
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-1 
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Return  Values 


Meanin 


Unsuccessful. 


Successful. 


Error  Name 


ANETACCESS 


Errors 


Reason  for  Error 


Cannot  access  Ethernet  interface. 


Calls 

Function 

Where  Described 

net  current  time 

Section  2.20.2.8.3. 

PRO  ASSOC  REQUEST  H 
DR  SIZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

AssocDeleteT  ransaction 

Section  2.20.1.23.3. 

net  snd 

Section  2.20.2.19.2. 

AssocRescheduleT  ransaction 

Section  2.20.1.23.5. 

Function 


AssocTickAssocLaver 


Called  B 


Where  Described 


Section  2.20.1.8.1. 


Table  2.20-29  UpdateTransactions  Information. 

2.20.1.9  address.c 

/simnet/libsrc/libassoc/address.c 

address.c  contains  a  routine  to  get  a  Simulation  Address. 

2.20.1.9.1  AssocGetSimAddress 

AssocGetSimAddress  gets  the  hosts  simulation  address.  It  sets  simAddress  to  the  site  and 
host  numbers  of  the  simulation  entity  referenced  by  handle.  These  are  taken  from  the 
definition  file  given  to  AssocOpen().  The  function  call  is  AssocGetSimAddress(handle, 
simAddress).  Table  2.20-30  describes  the  parameters  used,  return  values  and  possible 
errors  generated  by  using  this  function. 


Parameter 


handle 


simAddress 


Parameters 


pointer  to  Si mutation  Address 


Where  Typedef  Declared 


Standard  C  t 


/si  mnet/comrrx)  n/i  nclude/prot 
ocol/address.h 


Return  Values 


Return  Value 


-1 


Meaning 


Unsuccessful. 


Successful. 


Errors 

Error  Name 

Reason  for  Error 

ABADHANDLE 

Invalid  network  handle. 
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1  Calls  1 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

Table  2.20-30  AssocGetSimAddress  Information. 


2.20.1.10  error.c 

/simnet/libsrc/libassoc/error.c 


error.c  contains  all  the  definititHis  and  routines  used  for  the  association  layer  library’s  error 
handling  service.  Table  2.20-31  describes  the  variables  used  by  error.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

assoc  errno 

int 

Standard  C  type. 

errorList 

pointer  to  array 
MAX_ERROR_STRINGS  Of 
char 

Standard  C  type. 

Table  2.20-31  error.c  Variable  Information. 


2.20.1.10.1  AssocError 

AssocError  returns  a  pointer  to  a  static  string  that  describes  the  last  error  encountered 
during  an  association  library  call.  The  error  is  obtained  by  the  value  in  the  external 
variable  assoc_ermo.  AssocError  returns  a  pointer  to  the  string  “Error  0”  if  assoc_ermo 
equals  0.  Table  2.20-32  describes  the  return  values  generated  by  this  function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

errorList 

pointer  to  array  assoc_errno  of 
char 

String  for  a  valid  error  number. 

errorList 

pointer  to  array 
MAX_ERROR_STRINGS  Of 
char 

String  for  an  invalid  error 
number. 

2.20.1.11  close. c 

/simnet/libsrc/libassoc/close.c 


close.c  contains  a  routine  to  close  an  association  layer  channel. 

2.20.1.11.1  AssocClose 


AssocClose  deallocates  all  memoiy'  allocated  for  a  channel,  unsubscribes  from  al! 
subscribed  multicast  groups  and  closes  the  network  connection.  The  function  call  is 
AssocClose(handle).  Table  2.20-33  describes  the  parameters  used,  return  values  and 
possible  errors  generated  by  using  this  function. 


Parameter 

handle _ 


int 


e 


Parameters 


Where  Typedet  Declared 
Standard  C  type.  _ 
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1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

channel 

pointer  to  rgister 
ChannelDeschptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

ditch 

pointer  to  pointer  to  char 

Standard  C  type. 

next  Ditch 

pointer  to  pointer  to  char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

-1 

int 

Unsuccessful. 

association  channel  (and  net) 
handle 

int 

Successful. 

1  Errors  1 

Error  Name 

Reason  for  Error 

ABADHANDLE 

Invalid  network  handle. 

1  Calls  1 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/iibassoc/assoc  Ici.h. 

AssocUnsubscribeWithMask 

Section  2.20.1.1.5. 

net  close 

Section  2.20.2.3.1. 

Table  2.20-33  AssocClose  Information. 


2.20.1.12  family.c 

/simnet/libsrq/libassoc/family.c 


family.c  contains  a  routine  to  establish  a  protocol  family  to  be  used  for  a  channel. 

2.20.1.12.1  AssocSetProtocolFamily 

AssocSetProtocolFamily  re-initializes  the  network  layer  to  not  accept  packets  of  any  type, 
except  the  specified  family.  This  is  cuirendy  done  using  the  ethemet  type  code.  This  call 
is  only  needed  to  change  types  from  the  default  specified  in  the  channel’s  assocDef  file. 
Family  types  are  defined  in  assoc.h.  They  include: 


AssocFamilySimnet 

AssocFamilyData 

AssocFamilyVoice 

AssocFamilyGT 


listens  to  SIMNET  packets 
for  network  development  only 
listen  to  voice  (radio)  packets 
listen  to  GT  sim/cig  packets 


The  function  call  is  AssocSetProtocolFamily(handle,  family).  Table  2.20-34  describes  the 
parameters  used,  return  values  and  possible  errors  generate  by  using  this  function. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

family 

int 

Standard  C  type. 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Call  failed. 

0 

int 

New  family  is  set. 

Errors 

Error  Name 

Reason  for  Error 

ANETACCESS 

Cannot  access  interface  to  the  Ethemet. 

ABADHANDLE 

Invalid  handle  (have  you  called  AssocOpenO?). 

Calls 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

net  init  type 

Section  2.20.2.18.2. 

net  add  type 

Section  2.20.2.18.1. 

net  set  snd  type 

Section  2.20.2.19.8. 

Table  2.20*34  AssocSetProtocolFamily  Information. 

2.20.1.13  mask.c 

/sininet/libsrc/libassoc/mask.c 

mask.c  contains  routines  to  use  address  masks.  Address  masks  allow  the  user  to  utilize 
available  bits  in  the  ethemet  multicast  address  to  create  private  multicast  groups.  This  is 
considered  and  extension  to,  not  part  of,  the  Association  Layer. 

2.20.1.13.1  AssocSetSendMask 

AssocSetSendMask  allows  the  used  to  specify  a  mask  to  be  bit-wise  ORcA  into  a  multicast 
destination  address  before  it  is  sent.  This  allows  users  to  form  private  multicast  groups. 
Bits  0->23  of  the  mask  are  (9f?ed  with  bits  8->31  of  the  destination  address  to  form  bits 
8->31  of  the  actual  multicast  address  to  be  used.  Normally ,  these  bits  are  0.  The  mask  set 
by  AssocSetSendMask  is  used  for  sending  datagrams  and  transaction  requests. 

Transaction  responses  normally  use  the  mask  in  the  address  to  which  the  originator  sent  the 
request.  The  function  call  is  AssocSetSendMask(handle,  mask).  Table  2.20-35  describes 
the  parameters  used,  return  values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

mask 

unsiqned  long 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccesstui. 

0 

ini 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

ABADHANDLE 

Invalid  handle  (have  you  called  AssocOpenf)?' 

1  1 
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1  Calls  1 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

Table  2.20-35  AssocSetSendMask  Information. 


2.20.1.13.2  AssocGetRspMask 

AssocGetRspMask  is  used  in  conjunction  with  AssocSetRspMask  to  allow  the  user  to 
process  transactions  in  different  groups  out  of  order.  AssocGetRspMask  is  used  to  retrieve 
a  response  mask  when  a  transaction  is  first  received.  The  mask  is  then  used  by 
AssocSetRspMask  in  the  response.  The  function  call  is  AssocGetRspMask(handle,  mask). 
Table  2.20-36  describes  the  parameters  used,  return  values  and  possible  errors  generated 
by  using  this  function. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

mask 

unsiqned  long 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

1  Errors  1 

Error  Name 

Reason  for  Error 

ABADHANDLE 

Invalid  handle  (have  you  called  AssocOpenO?). 

1  Calls  1 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

Table  2.20-36  AssocGetRspMask  Information. 


2.20.1.13.3  AssocSetRspMask 

AssocSetRspMask  is  used  with  AssocGetRspMask.  The  mask  retrieved  by 
AssocGetRspMask  is  used  to  send  a  response  by  first  calling  AssocSetRspMask  and  then 
AssocSendResponae.  The  function  call  is  AssocSetRspMask(handle,  mask).  Table  2.20- 
37  describes  the  parameters  used,  return  values  and  possible  errors  generate  by  using  this 
function. 


Parameters 


Parameter 


handle 


mask 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  type. 


Return  Values 


Return  Value 


-1 


Meaning 


Unsuccessful. 


Successful. 
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1  Errors  1 

Error  Name 

Reason  for  Error 

ABADHANDLE 

Invalid  handle  (have  you  called  AssocOpenO?). 

Calls 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

Table  2.20-37  AssocSetRspMask  Information. 

2.20.1.14  raw.c 

/simnet/libsrc/libassoc/raw.c 

raw.c  contains  a  routine  to  receive  raw  Association  PDUs  from  the  SIMNET  network 
through  the  association  layer.  Table  2.20-38  describes  the  variables  used  by  raw.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

errno 

extern  int 

Standard  C  type. 

Table  2.20-38  raw.c  Variable  Information. 

2.20.1.14.1  AssocReceiveAssocPDU 

AssocReceiveAssocPDU  gets  a  pointer  to  the  next  available  Association  PDU  (APDU)  in 
the  network  buffers  and  sets  whatdaw  points  to  to  this  pointer  when  appropriate.  The  data 
pointer  will  not  be  set  if  the  APDU  is  a  response  to  a  transaction  the  application  issued  or  if 
the  APDU  is  a  retry  for  which  the  application  has  a  response  cached.  If  the  APDU  is  a 
response  to  a  transaction  the  application  issued,  the  association  entity  calls  the  supplied 
callback  routine  and  returns  with  primitive  equal  to  ASSC)C_TRANSACT_CONTF.  If  the 
APDU  is  a  retry  request  for  which  the  application  has  a  cached  response,  the  association 
entity  retransmits  the  response  and  returns  with  primitive  equal  to 
ASSOC_NOTHING_OF_INTEREST.  When  AssocReceiveAssocPDU  returns  a  pointer 
to  an  APDU,  protocol  is  the  user  protocol  to  which  the  PDU  contained  in  the  APDU 
belongs,  and  primitive  indicates  whether  the  PDU  is  a  datagram,  request,  etc.,  as  defined  in 
“assoc.h”.  length  is  the  number  of  bytes  in  the  information  pointed  to  by  data.  The 
function  call  is  AssocReceiveAssocPDU (handle,  data,  length,  primitive).  Table  2.20-39 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

data 

pointer  to  pointer  to  char 

Standard  C  type. 

lenqth 

pointer  to  long  int 

Standard  C  type. 

primitive 

pointer  to  long  int 

Standard  C  type. 
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Internal  Variables 

Variable 

Where  Typedef  Declared 

channel 

register  pointer  to 
ChanneiOescriDtor 

/simnet/libsrc/iibassoc/assocj 

cl.h 

inter  to  char 


pointer  to  AssooationPDU 


acketLen 


retVal 


u  data 


du  lenoth 


group 


protocol 


onginator 


transID 


respondent 


MuiticastGroupIO 


AssociationUserProtocol 


SimulationAddress 


T  ransactionidentifier 


SimulationAddress 


Standard  C  t 


/simnel/common/include/prot 
ocol/D  assoc. h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


/simnet/common/include/prot 
ocol/D  assoc.h 


/si  mnet/common/i  nclude/prot 
ocol/D  assoc.h 


/simnet/common/include/prot 

ocol/address.h 


/simnet/common/include/prot 

ocol/address.h 


/simnet/common/mclude/prot 

ocol/address.h 


Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Read  failed. 

0 

int 

Data  is  returned. 

1 

int 

No  data  is  returned  and 
network  buffers  are  not  emotv. 

2 

int 

Network  buffers  are  empty. 

Error  Name 


AN ET ACC ESS 


Errors 


Reason  for  Error 


Cannot  access  interface  to  the  Ethernet. 


Calls 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

net  release  rev 

Section  2.20.2.17.10. 

net  aet  rev 

Section  2.20.2.17.9. 

AssocProcessRequestPDU 

Section  2.20.1.20.1. 

Assoc  ProcessResponsePDU 

Section  2.20.1.19.1. 

Table  2.20-39  AssocReceiveAssocPDU  Information. 
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Table  2.20-40  lists  the  values  returned  in  primitive. 


Value 

Description 

ASSOC_NOTHING_OFJNTEREST 

Padding  PDU  or  Association  Layer  retransmitted  a 
cached  response. 

ASSOC  DATAGRAM  IND 

Dataaram  PDU. 

ASSOC  REQUEST  IND 

Transaction  reauest  to  which  we  are  an  observer. 

ASSOC  RESPONSE  IND 

Transaction  response  to  which  we  are  an  observer. 

ASSOC  TRANSACT  IND 

Transaction  request  destined  for  my  host. 

ASSOC  TRANSACT  CONF 

Association  layer  process  a  callback  routine. 

Table  2.20-40  Values  Returned  in  Primitive  of  AssocReceiveAssocPDU. 


2.20.1.15  who.c 

/simnet/libsrc/libassoc/who.c 

who.c  contains  a  routine  to  determine  the  ethemet  addres  of  the  current  packet  on  each 
channel. 

2.20.1.15.1  AssocGetLastAddress 

AssocGetLastAddress  sets  the  buffer  pointed  to  by  who  to  the  physical  ethemet  address  of 
the  sender  of  the  last  packet  which  was  returned  to  the  application  (or  Null  if  none  has  been 
received).  This  can  be  useful  for  debugging  the  network.  This  is  considered  an  extension 
to,  rather  than  a  part  of,  the  association  layer.  The  function  call  is 
AssocGetLastAddress(handle,  who).  Table  2.20-41  describes  the  parameters  used,  return 
values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

handle 

int 

Standard  C  type. 

who 

pointer  to  NetworkAddress 

/simnet/libsre/libnetif/network. 

h 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

ABADHANDLE 

Invalid  handle  (have  you  called  AssocOpenO?). 

Calls 

Function 

Where  Described 

ASSOC  CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 

net  qet  rev  from  addr 

Section  2.20.2.17.4. 

Table  2.20-41  AssocGetLastAddress  Information. 
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2.20.1.16  time^list.c 

/simnet/libsic/libassoc/time_list.c 

time_list.c  ccMitains  routines  used  to  maintain  linked  lists  of  pending  transactions.  These 
lists  are  linked  in  order  by  time.  Each  transaction  in  the  list  has  a  pointer  to  the  previous 
transaction  in  time  (the  timeFront  pointer)  and  to  the  next  transaction  in  time  (the  timeRear 
pointer). 


2.20.1.16.1 


AssocAddToStartOfTimeList 


AssocAddToStartOfTimeList  adds  the  transaction^/  to  the  start  of  the  TimeList.  The 
routine  makes  sure  that  starfTimeList  points  to  the  first  transaction  pointer  on  the  TimeList 
and  endTimeList  points  to  the  last  transaction  pointer  on  the  TimeList.  The  function  call  is 
AssocAddToStartOfTimeList(td,  startTimeList,  endTimeList).  Table  2.20-42  describes  the 
parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

td 

pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

StartTimeList 

pointer  to  pointer  to 
AssocTransDescriotor 

/simnet/libsrc/libassoc/assocj 

cl.h 

endTimeList 

pointer  to  pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

Table  2.20-42  AssocAddToStartOfTimeList  Information. 


2.20.1.16.2 


AssocAddToEndOfTimeList 


AssocAddToEndOfTimeList  adds  the  transactionrd  to  the  end  of  the  I'imeList.  The  routine 
makes  sure  that  starfTimeList  points  to  the  first  transaction  pointer  on  the  TimeList  and 
endTimeList  points  to  the  last  transaction  pointer  on  the  TimeList.  The  function  call  is 
AssocAddToEndOfTimeList(td,  startTimeList,  endTimeList).  Table  2.20-43  describes  the 
parameters  used  by  this  function. 


Parameter 


td 


StartTimeList 


endTimeList 


Parameters 


e 


pointer  to 

AssocTransDescriotor 


pointer  to  pointer  to 
AssocT  ransDescriptor 


pointer  to  pointer  to 
AssocT  ransDescriptor 


Where  Typedef  Declared 


/simnet/libsrc/libassoc/assocj 

cl.h 


/simnet/libsrc/libassoc/assoc_l 

cl.h 


/simnet/libsrc/libassoc/assoc_l 

cl.h 


Function 


AssocCacheResponse 


AssocAddT  ransaction 


Called  B 


Where  Described 


Section  2.20.1.18.2. 


Section  2.20.1.23.2. 


Table  2.20-43  AssocAddToEndOfTimeList  InformaMon. 
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2.20.1.16.3  AssocDeleteF  romTimeList 

Asscx^DeleteFromTimeList  deletes  the  transaction  td  from  the  TimeList.  The  routine  makes 
sure  that  startTimeList  points  to  the  first  transaction  pointer  on  the  TimeList,  that 
endTimeList  points  to  the  last  transaction  pointer  on  the  TimeList,  and  that  the  Tin^eList 
elements  remain  properly  linked  by  the  timerFront  and  timeRear  pointers  when  td  is 
removed  from  the  list.  The  function  call  is  AssocDeleteFiomTimeList(td,  startTimeList, 
endTimeList).  Table  2.20-44  describes  the  parameters  used  by  this  function. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

td 

pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

StartTimeList 

pointer  to  pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

endTimeList 

pointer  to  pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

Called  By 

Function 

Where  Described 

AssocDeleteCachedRespons 

e 

Section  2.20.1.18.3. 

AssocDeleteT  ransaction 

Section  2.20.1.23.3. 

Table  2.20-44  AssocDeleteFromTimeList  Information. 
2.20.1.16.4  AssocMoveT  oEndOfTimeList 

AssocMoveToEndOfTimeList  moves  the  transaction  td  to  the  end  of  the  TimeList.  The 
routine  makes  sure  that  startTimeList  points  to  the  first  transaction  pointer  on  the  TimeList 
and  endTimeList  points  to  the  last  transaction  pointer  on  the  TimeList.  The  function  call  is 
AssocMoveToEndOfTimeList(td,  startTimeList,  endTimeList).  Table  2.20-45  describes 
the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

td 

pointer  to 

AssocT  ransDescriptor 

/simneVlibsrc/libassoc'assocJ 
cl  h 

StartTimeList 

pointer  to  pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assoc  _l 
cl.h 

endTimeList 

pointer  to  pointer  to 

AssocT  ransDescriptor 

/simnet/lib?.rc/iibassoc/assoc_l 

cl.h 

1  Called  By  I 

Function 

Where  Described 

AssocRescheduleT  ransaction 

Section  2.20.1.23.5. 

Table  2.20-45  AssocMoveToEndOfTimeList  Information. 
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2.20.1.17  strtok.c 

/simnet/libsrc/libassoc/stnok.c 

Table  2.20-46  describes  the  variables  used  by  strtok.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

tok  but 

array  512  of  char 

Standard  C  type. 

tok  cp 

pointer  to  char 

Standard  C  type. 

Table  2.20-46  strtok.c  Variable  Information. 

2.20.1.17.1  strtok 

stTtok  is  a  utility  function  used  to  parse  strings.  It  performs  the  same  functionality  as  the 
Unix  function  strtok().  The  function  call  is  strtok(operand,  set).  Table  2.20-47  describes 
the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

operand 

pointer  to  char 

Standard  C  type. 

set 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

ret  val 

pointer  to  char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

0 

pointer  to  char 

the  string  was  empty 

ret val 

pointer  to  char 

the  parsed  string 

1  Called  Bv  1 

Function 

Where  Described 

AssocReadParams 

Section  2.20.1.22.2. 

Table  2.20-47  strtok  Information. 

2.20.1.18  respondent.c 

/simnet/libsrc/libassoc/rcspondent.c 

respondentc  contains  routines  to  implement  the  portion  of  the  transaction  protocol  where 
this  host  is  the  respondent.  Each  element  of  responseMap  is  a  pointer  to  a  list  or  "bucket" 
of  response  descriptors.  The  transaction  IDs  of  all  transactions  in  a  bucket  have  low  order 
7  bits  that  correspond  to  the  map  index,  meaning  that  the  low  order  7  bits  can  be  used  to 
index  the  appropriate  bucket. 
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2.20.1.18.1 


AssocInitResponse 


AssocInitResponse  is  called  by  AssocOpen  to  set  up  a  response  bucket  map.  The  function 
call  is  AssocInitResponse(handle).  Table  2.20-48  describes  the  parameters  used  by  this 
function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Tvpedcf  Declared 

i 

reaister  int 

Standard  C  typo. 

rd 

register  pointer  to  pointer  to 
AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assoc_l 

cl.h 

channel 

pointer  to  ChannelDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

1  Called  Bv  1 

Function 

Where  Described 

AssocOpen 

Section  2.20.1.5.1. 

AssocAttach 

Section  2.20.1.5.2. 

Table  2.20-48  AssocInitResponse  Information. 


2.20.1.18.2  AssocCacheResponse 


AssocCacheResponse  is  called  by  AssocSendResponse  (Section  2.20.1.4.2)  when  a 
cached  response  is  sent  by  the  host.  AssocSendResponse  gets  a  descriptor  for  the 
response  and  fills  in  the  pidubuf  and  length  fields.  AssoCacheResponse  then  links  the 
response  into  the  appropriate  bucket  for  its  transaction  id  and  fills  in  any  other  descriptor- 
specific  fields.  The  function  call  is  AssocCacheResponse(handle,  rd).  Table  2.20-49 
describes  the  parameters  used  and  functions  called  using  tlds  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

rd 

pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assoc  _l 
cl.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

apdu 

register  pointer  to 
AssociationPDU 

/simnet/common/include/prot 
ocol/p  assoc. h 

channel 

register  pointer  to 
ChannelDescriptor 

/simnet/libsrc/libassoc/assoc_l 

cl.h 

1  Calls  1 

Function 

Where  Described 

net  current  time 

Section  2.20.2.8.3. 

Assoc  AddToBucket 

Section  2.20.1.25  1. 

AssocAddToEndOfTimeList 

Section  2.20.1.16.2. 
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1  Called  Bv  1 

Function 

Where  Described 

AssocSendResponse 

Section  2.20.1.4.2. 

Table  2.20-49  AssocCacheResponse  Information. 
2.20.1.18.3  AssocDeleteCachedResponse 

AssocDeleteCachedResponse  is  called  when  a  cached  response  times  out.  The  response  is 
removed  from  the  time  list,  removed  from  the  bucket  list,  and  added  to  the  free  list.  The 
parameter  rd  references  the  response  transacticm  descriptor.  The  function  call  is 
AssocE>eleteCachedResponse(handle,  rd).  Table  2.20-50  describes  the  parameters  used 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Tvpe 

Where  Tvpedef  Declared 

handle 

int 

Standard  C  tvoe. 

rd 

pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

channel 

register  pointer  to 
ChannelDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

Calls 

Function 

Where  Described 

AssocDeleteFromTimeList 

Section  2.20.1.16.3. 

AssocDeleteFromBucket 

Section  2.20.1.25.2. 

AssocFreeDescriptor 

Section  2,20.1.24.4. 

Called  Bv 

Function 

Where  Described 

AssocTimeOutOldResponses 

Section  2.20.1.18.4. 

Table  2.20-50  AssocDeleteCachedResponse  Information. 
2.20.1.18.4  AssocTimeOutOldResponses 

AssocTimeOutOldResponses  goes  through  the  time  list  and  deletes  all  responses  older  than 
CacheTime.  It  is  called  either  from  AssocTickAssocLayer  or  when  the  FreeList  is  empty, 
in  an  attempt  to  free  up  some  space.  The  function  call  is 

AssocTimeOutOldResponses(handle).  Table  2.20-51  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

■  Parameter 

Type 

Where  Typedef  Declared 

1  handle 

int 

Standard  C  type. 
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\  Internal  Variables  I 

Variable 

Where  Tvoedef  Declared 

tl 

register  pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/iibassoc/assocj 

cl.h 

next 

pointer  to 

AssocTransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

channel 

pointer  to  ChannelDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

currentTicks 

lonq  int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

net  current  time 

Section  2.20.2.8.3. 

AssocOeletedCachedRespon 

se 

Section  2.20.1.18.3. 

1  Called  By  I 

Function 

Where  Described 

AssocTickAssocLaver 

Section  2.20.1.8.1. 

AssocGet  Descriptor 

Section  2.20.1.24.3. 

Table  2.20-51  AssocTimeOutOldResponses  Information. 


2.20.1.18.5  AssocFindResponse 

AssocFindResponse  is  called  when  a  transaction  request  arrives,  to  see  if  there  is  a 
response  cach^  and  waiting  for  it.  The  function  call  is  AssocFindResponse(handle, 
originator,  tid).  Table  2.20-52  describes  the  parameters  used  and  functions  called  using 
this  function. 


Parameter 


handle 


originator 


Parameters 


Where  Tvoedef  Declared 


Standard  C  type. 


pointer  to  Simulation  Address  /simnet/common/include/prot 

ocol/address.h 


T  ransactionidentifier 


/si  mnet/common/i  nclude/prot 
ocol/address  h 


Return  Value 


AssocBucketLookup 
(originator,  tid, 
channelMapfhandle]  -> 
responseMap 
(RESPONSE  ID  MASK 


Return  Values 


Type  _ 


pointer  to 

AssocT  ransDescriptor 


Meaning 


The  transaction  descriptor  of  a 
cached  response  to  the 
transaction  request. 


Function 


AssocBucketLooku 


Calls 


Where  Described 


Section  2.20.1.25.3. 


780 


BBN  Systems  and  Technologies 


MCC  CSCI 


_ _ Called  By 

Function  Where  Described 

AssocProcessRequestPDU  Section  2.20.1 .20.1 . 


Table  2.20-52  AssocFindResponse  Information. 

2.20.1.19  proc_rsp.c 

/sininet/libsrc/libassbc^roc_rsp.c 

proc_rsp.c  contains  a  routine  to  process  a  response  APDU. 

2.20.1.19.1  AssocProcessResponsePDU 

AssocProcessResponsePDU  is  called  by  AssocReceivePDU  in  order  to  process  a  response 
PDU.  The  routine  first  determines  if  the  res^nse  was  intended  for  the  invoking  process. 
If  so,  it  determines  which  transaction  was  being  responded  to,  invokes  the  call  back 
routine,  and  deletes  the  transaction  from  the  pending  list.  If  the  transaction  cannot  be 
found,  the  response  is  thrown  away.  If  the  response  was  not  intended  for  the  invoking 
process,  it  is  treated  as  a  datagram.  The  function  call  is 

AssocProcessResponsePDU (handle,  apdu,  data,  length,  ^oup,  protocol,  primitive, 
originator,  transID,  respondent,  rc).  Table  2.20-53  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

handle 

int 

Standard  C  type. 

apdu 

register  pointer  to 
AssociationPDU 

/simnet/common/include/prot 
ocol/p  assoc.h 

data 

pointer  to  pointer  to  char 

Standard  C  type. 

length 

pointer  to  long  int 

Standard  C  type. 

group 

pointer  to  MulticastGroupID 

/si  mnet/co  mmo  n/i  nclude/prot 
ocol/p  assoc.h 

protocol 

pointer  to 

Associatio  nU  serProtocol 

/simnet/common/include/prot 
ocol/p  assoc.h 

primitive 

pointer  to  tong  int 

Standard  C  type. 

originator 

pointer  to  Simulation  Address 

/simnet/common/include/prot 

ocol/address.h 

transID 

pointer  to  Transactionidentifier 

/simnet/common/include/prot 

ocol/address.h 

respondent 

pointer  to  Simulation  Address 

/simnet/comnfX)n/include/prot 

ocol/address.h 

rc 

pointer  to  int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

td 

register  pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

1  Calls  1 

Function 

Where  Described 

ASSOC  ADDRESS  EQUAL 

Macro  defined  in  /simnet/libsrc/libassoc/assoc.h. 

AssocFi  ndT  ransaction 

Section  2.20.1.23.4. 

AssocDelefeTransaction 

Section  2.20.1.23.3. 
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1  Called  By  1 

Function 

Where  Described 

AssocReceivePDU 

Section  2.20.1.6.1. 

AssocWaitForPDU 

Section  2.20.1.7.1. 

AssocReceiveAssocPDU 

Section  2.20.1.14.1. 

Table  2.20*54  AssocProcessResponsePDU  Information. 


2.20.1.20  proc_req.c 

/sitnnet/libsrc/libassoc^roc_req.c 

proc_req.c  contains  a  routine  to  process  a  request  APDU. 

2.20.1.20.1  AssocProcessRequestPDU 

AssocProcessRequestPDU  is  called  by  AssocReceivePDU  in  order  to  process  a  request 
PDU.  The  routine  first  determines  if  the  request  was  intended  for  the  invoking  process.  If 
so,  it  determines  whether  a  response  is  cached  for  the  request.  If  no  response  is  cached, 
the  request  is  passed  to  the  host  for  processing.  If  a  response  is  cached,  it  is  re¬ 
transmitted.  If  the  request  was  not  intended  for  the  invoking  process,  it  is  treated  as  a 
datagram.  The  function  call  is  AssocProcessRequestPDU (handle,  apdu,  data,  length, 
group,  protocol,  primitive,  originator,  transID,  respondent,  rc).  Table  2.20-55  describes 
^e  parameters  used,  errors  returned  and  functions  called  using  this  function. 


Parameter 


handle 


apdu 


data 


lenath 


group 


protocol 


rimitive 


onginator 


transID 


respondent 


variable 


rd 


reqAddress 


Parameters 


int 


register  pointer  to 
AssociationPDU 


inter  to  pointer  to  char 


inter  to  Iona  int 


pointer  to  MulticastGroupID 


pointer  to 

AssociationUserProtocol 


inter  to  Iona  int 


pointer  to  SimulationAddress 


pointer  to  Transactionidentifier 


pointer  to  SimulationAddress 


inter  to  int 


Where  Tvoedef  Declared 


Standard  C  t 


/simnet/common/include/prot 
ocol/p  assoc.h 


Standard  C  type. 


Standard  C  type. 


/simnet/common/include/prot 
ocol/p  assoc.h 


/simnet/common/include/prot 
ocol/p  assoc.h 


Standard  C  type. 


/simnet/common/mclude/prot 

ocol/address.h 


/simnet/common/include/prot 
ocol/address  h 


/simnet/common/include/prot 

ocol/address.h 


Standard  C  type. 


Internal  Variables 


e 


register  pointer  to 
AssocT  ransDescriptor 


NetworkAddress 


Where  Tvpedef  Declared 


/simnet/libsrc/libassoc/assoc_i 

cl.h 


/simnet  iibsrc/libnetif/network. 
h 
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1  Return  Values  1 

Return  Value 

ElTSiHHiHHH 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

I  Errors  I 

Error  Name 

Reason  for  Error 

ANETACCESS 

Cannot  access  interface  to  the  Ethernet 

I  Calls  I 

Function 

Where  Described 

ASSOC  ADDRESS  EQUAL 

Macro  defined  in  /simnet/libsrc/libassoc/assoc.h. 

AssocFindResDonse 

Section  2.20.1.16.5. 

net  aet  rev  to  addr 

Section  2.20.2.17.3. 

net  snd 

Section  2.20.2.19.2. 

I  Called  Bv  I 

Function 

Where  Described 

Assoc  Receive  P  DU 

Section  2.20.1.6.1. 

AssocWaitForPDU 

Section  2.20.1.7.1. 

AssocReceiveAssoePDU 

Section  2.20.1.14.1. 

Table  2.20*55  AssocProcessRequestPDU  Information. 

2.20.1.21  proc_dgram.c 

/sininet/libsrc/libassbc/proc_dgram.c 

proc_dgram.c  contains  a  routine  for  processing  datagrams. 

2.20.1.21.1  AssocProcessDatagramPDU 

AssocProcessDatagramPDU  is  used  to  process  datagrams,  however,  is  not  called  with  the 
version  6.6  code;  the  macro  PRC)CESS_DATAGRAM_PDU  is  called  instead. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

apdu 

register  pointer  to 
AssociationPDU 

/si  mnet/commo  n/i  nclude/prot 
ocol/p  assoc,  h 

data 

pointer  to  pointer  to  char 

Standard  C  type. 

lenqth 

pointer  to  long  int 

Standard  C  type. 

group 

pointer  to  MulticastGroupID 

/simnet/common/i  nclude/prot 
ocol/p  assoc.h 

protocol 

pointer  to 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc.h 

primitive 

pointer  to  long  int 

Standard  C  type. 

originator 

pointer  to  Si  mutation  Address 

/simnet/common/include/prot 

ocol/address.h 

Table  2.20*56  AssocProcessDatagramPDU  Information. 
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2.20.1.22  params.c 

/simnet/libsn^bassoc^arams.c 


params.c  contains  routines  to  get  the  association  layer  parameters  for  one  channel  from  an 
“assoc.def  ’  file.  Table  2.20^57  describes  the  variables  used  by  params.c. 


1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

params 

array  numParams  of  PARAM 

/si  mnet/libsrc/libassoc/params . 
c 

famlKes 

array  MAX_FAMILIES  of  struct 
famiies 

/si  mnet/libsrc/libassoc/params . 
c 

Table  2.20-57  parains.c  Variable  Information. 
2.20.1.22.1  upshift 

upshift  converts  tokens  from  assoc.def  to  upper  case.  The  function  call  is  upshift(str). 
Table  2.20-58  describes  the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

str 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

CP 

reqister  pointer  to  char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

str 

pointer  to  char 

Upshifted  token. 

1  Called  By  I 

Function 

Where  Described 

AssocReadParams 

Section  2.20.1.22.2. 

ProcessProtocolFamilv 

Section  2.20.1.22.8. 

Table  2.20-58  upshift  Information. 
2.20.1.22.2  AssocReadParams 


AssocReadParams  is  called  to  read  in  the  ASCII  parameter  file,  assocDef.  The  function  call 
is  AssocReadParams(handle,  assocDef).  Table  2.20-59  describes  the  parameters  used, 
errors  returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

assocDef 

pointer  to  char 

Standard  C  type. 
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Variable 


del 


but 


tokRr 


channel 


Internal  Variables 


inter  to  FILE 


array 

ASSCXJ_PARM_MAX_LINE_ 
1  Of  Char 


inter  to  char 


pointer  to  ChannelDescriptor 


register  pointer  to  PARAM 


reaister  int 


Return  Values 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  type. 


Standard  C  t 


/simnet/libsrc/libassoc/assocj 

cl.h 


/simnet/Hbsrc/libassoc/params. 

c 


Standard  C  t 


Return  Value 


-1 


Meanin 


int 

Unsuccessful. 

int 

Successful. 

Error  Name 


AFILEOPEN 


APARM 


Errors 


Reason  for  Error 


Cannot  ooen  the  assocDef  file. 


Missino  or  invalid  site  and/or  hose  oarameter  is  assocDef  file. 


Function 


ASSOC  CHECK  HANDLE 


strtok 


upshift 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libassoc/assoc  Icl.h. 


Section  2.20.1.17.1. 


Section  2.20.1.22.1. 


Called  B 


Function 

Where  Described 

AssocOpen 

Section  2.20.1.5.1. 

AssocAttach 

Section  2.20.1.5.2. 

2.20.1.22.3 


Table  2.20-59  AssocReadParams  Information. 
ProcessSite 


ProcessSite  processes  the  site  parameter  (read  from  the  assocDef  file)  for  the  channel 
described  by  channel.  The  function  call  is  ProcessSite(channel,  tokPtr).  Table  2.20-60 
describes  the  parameters  used  by  this  function. 


Parameter 


channel 


tokRr 


Parameters 


Where  Tvpedef  Declared 


pointer  to  ChannelDescriptor  /simnet/libsrc/libassoc/assocj 

cl.h 


inter  to  char  I  Standard  C  type. 


Internal  Variables 


Variable 


site 


Where  Tvoedef  Declared 


Standard  C  type. 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

Table  2.20-60  ProcessSite  Information. 


2.20.1.22.4  ProcessHost 


ProcessHost  processes  the  host  parameter  (read  fnxn  the  assocDef  file)  for  the  channel 
described  by  chonne/.  The  function  call  is  ProcessHost(channel,  tokPtr).  Table  2.20-61 
describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

channel 

pointer  to  ChannelDescriptor 

/simnet/libsrc/libassoc/assoc  1 
cl.h 

tokPtr 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

host 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

Table  2.20-61  ProcessHost  Information. 


2.20.1.22.5  ProcessMaxSu  bscriptions 

ProcessMaxSubscriptions  processes  the  maxSubscriptions  parameter  (read  from  the 
assocDef  file)  for  the  channel  described  by  channel.  The  function  call  is 
ProcessMaxSubscriptions(channel,  tokPtr).  Table  2.20-62  describes  the  parameters  used 
by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

channel 

pointer  to  ChannelDescriptor 

/simnet'libsrr,/libassoc/assoc_l 

cl.h 

tokPtr 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

subscriptions 

int 

Standard  C  type 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

Tabic  2.20-62  Procc.s.sMaxSubscriplions  Information 
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2.20.1.22.6  ProcessInitDescriptors 

ProcessInitDescriptors  processes  the  initDescriptors  parameter  (read  from  the  assocDef  file) 
for  the  channel  describe  by  channel.  The  function  call  is  ProcessInitDescriptors(channel, 
tokPtr).  Table  2.20-63  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

channel 

pointer  to  ChannelDescriptor 

/simnet/iibsrc/libassoc/assoc  I 
cl.h 

tokPtr 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

initDescriptors 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

Table  2.20-63  ProcessInitDescriptors  Information. 
2.20.1.22.7  Process  AddIDescriptors 

ProcessAddlDescriptors  processes  the  addlDescriptors  parameter  (read  from  the  assocDef 
file)  for  the  channel  described  by  channel.  The  function  call  is 

ProcessAddlDescriptors(channel,  tokPtr).  Table  2.20-64  describes  the  parameters  used  by 
this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

channel 

pointer  to  ChannelDescriptor 

/simnet/iibsrc/libassoc/assoc  I 
cl  h 

tokRr 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

addlDescriptors 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

Table  2.20-64  ProcessAddlDescriptors  Information. 
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2.20.1.22.8  ProcessProtocolFamily 

ProcessProtocolFamily  processes  the  family  parameter  (read  from  the  assocDef  file)  for  the 
channel  described  by  channel.  The  function  call  is  ProcessProtocolFamily(channel, 
tokPtr).  Table  2.20-65  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

channel 

pointer  to  ChannelDeschptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

tokPtr 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

register  int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

1  Calls  1 

Function 

Where  Described 

upshift 

Section  2.20.1.22.1. 

Table  2.20-65  ProcessProtocolFamily  Information. 

2.20.1.23  origin. c 

/simnet/libsrc/libassoc/origin.c 

origin.c  contains  routines  to  implement  that  portion  of  the  transaction  protocol  where  this 
host  is  the  originator. 

2.20.1.23.1  AssocInitTransactions 

AssoclnitTransactions  is  called  by  AssocOpen  to  set  up  a  transaction  bucket  maji.  The 
function  call  is  AssocInitTransactions(handle).  Table  2.20-66  describes  the  parameters 
used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  int 

Standard  C  type. 

td 

register  pointer  to  pointer  to 
AssocT  ransDescriptor 

/simnet'libsrc/libassoc/assocj 

cl.h 

channel 

register  pointer  to 
ChannelDescripfor 

/simnet/libsrc'libassoc/assocj 
cl  h 

1  1 
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1  Called  Bv  1 

Function 

Where  Described 

AssocOpen 

Section  2.20.1.5.1. 

AssocAttach 

Section  2.20.1.5.2. 

Table  2.20-66  AssocInitTransactions  Information. 
2.20.1.23.2  AssocAddTransaction 

Assoc AddTransaction  is  called  when  the  host  sends  a  transaction.  It  is  placed  at  the  head 
of  the  appropriate  transaction  bucket,  and  put  at  the  end  of  the  timeList. 
AssocAddTransaction  assumes  that  Ae  transaction  descriptor,  td,  already  has  the  PDU 
copied  in.  The  function  call  is  AssocAddTransaction(handle,  td,  callback,  cparam, 
timeout,  tparam).  Table  2.20-67  describes  the  parameters  used  and  functions  called  using 
this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

td 

register  pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

(callback)() 

pointer  to  function  returning 
int 

Standard  C  type. 

pointer  to  long  int 

Standard  C  type. 

(timeout)() 

pointer  to  function  returning 
int 

Standard  C  type. 

tparam 

pointer  to  long  int 

Standard  C  type. 

Interna!  Variables 

Variable 

Type 

Where  Typedef  Declared 

apdu 

register  pointer  to 
AssociationPDU 

/si  mnet/co  mmo  n/i  nclude/prot 
ocol/p  assoc. h 

channel 

pointer  to  ChannelDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

1  Calls  1 

Function 

Where  Described 

net  current  time 

Section  2.20.2.8.3. 

AssocAddToEndOfTimeList 

Section  2.20.1.16.2. 

AssocAddToBucket 

Section  2.20.1.25.1. 

1  Called  Bv  1 

Function 

Where  Described 

AssocSendT  ransact 

Section  2.20.1.4.1. 

Table  2.20-67  AssocAddTransaction  Information. 
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2.20.1.23.3  AssocDeleteTransaction 

AssocDeleteTransaction  removes  a  transaction  either  1)  when  a  response  is  received,  or  2) 
when  it  has  been  sent  retryCountTime.  The  function  c^  is 

AssocDeleteTransaction(handle,  td).  Table  2.20-68  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  !ypedef  Declared 

handle 

int 

Standard  C  type. 

td 

pointer  to 

Assoc!  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

Internal  Variables 

Variable 

Where  !ypedef  Declared 

channel 

pointer  to  ChannelDescriptor 

/simnet/libsrc/libassoc/assoc  1 
cl.h 

1  Calls  1 

Function 

Where  Described 

AssocDeleteFromTimeList 

Section  2.20.1.16.3. 

AssocDeleteFromBucket 

Section  2.20.1.25.2. 

AssocFree  OescriDtor 

Section  2.20.1.24.4. 

1  Called  By  I 

Function 

Where  Described 

Update!  ransactions 

Section  2.20.1.8.2. 

AssocProcessResponsePDU 

Section  2.20.1.19.1. 

Table  2.20-68  AssocDeleteTransaction  Information. 


2.20.1.23.4  AssocFin  dT  ransaction 


When  a  response  PDU  arrives,  AssocFindTransaction  checks  to  see  if  a  transaction  with 
the  same  transaction  id  exists.  The  function  call  is  AssocFindTransaction(handle,  tid). 
Table  2.20-69  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

!voe 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

tid 

!  ransactionidentifier 

/simnet/common/include/prot 

ocol/address.h 

Return  Values 

Return  Value 

Type 

Meaning 

pointer  to 

Assoc!  rans  Descriptor 

/simnet/libsrc/libassoc/assoc  1 
cl.h 

Calls 

Function 

Where  Described 

AssocBucketLookup 

Section  2.20.1.25  3. 

1  1 
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1  Called  By  I 

Function 

Where  Described 

Assoc  ProcessResponsePDU 

Section  2.20.1.19.1. 

Table  2.20-69  AssocFindTransaction  Information. 
2.20.1.23.5  AssocRescheduleTransaction 

AssocRescheduleTransaction  is  called  after  a  transaction  has  been  retried.  The  transaction 
descriptor  is  moved  to  the  end  of  the  time  list  and  a  new  retry  time  is  calculated.  The 
function  call  is  AssocRescheduleTransaction(handle,  td).  Table  2.20-70  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

td 

pointer  to 

AssocT  rans  Descriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

channel 

pointer  to  ChannelDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

1  Calls  1 

Function 

Where  Described 

AssocMoveToEndOfTimeList 

Section  2.20.1.16.4. 

1  Called  By  1 

Function 

Where  Described 

UpdateTransactions 

Section  2.20.1.18.2. 

Table  2.20-70  AssocRescheduleTransaction  Information. 

2.20.1.24  free_list.c 

/simnet/libsrc/libassoc/frec.Kstx 

ftee_list.c  contains  routines  to  manage  the  free  list  of  transaction  descriptors.  The  free  list 
is  created  as  a  stack  at  intialization  time,  to  avoid  calling  mallocO  or  free()  each  time  a 
descriptor  is  needed. 

2.20.1.24.1  AssocCreateFreeList 

AssocCreateFreeList  creates  the  free  list  by  allocating  enough  space  for  a  certain  number  of 
descriptors  (ASSC)C_INITIAL_DESCRU^ORS  +  an  extra  char).  The  function  call  is 
AssocCreateFreeList(handle).  Table  2.20-71  describes  the  parameters  used  and  errors 
returned  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

1  1 

791 


BBN  Systems  and  Technologies 


MCC  CSCI 


Variable 


channel 


Internal  Variables 


reoister  int 


register  pointer  to 
AssocT  ransDescriptor 


register  pointer  to 
ChannelOescriotor 


Where  Tvpedef  Declared 


Standard  C  t 


/simnet/libsrc/libassoc/assocj 

cl.h 


/simnet/libsrc/libassoc/assocj 

cl.h 


Return  Value 


-1 


Return  Values 


Meanin 


Didn't  have  enough  memory 
to  create  list. 


Successful. 


Error  Name 


ANOM EMORY 


Errors 


Reason  for  Error 


Not  enouoh  memory  for  internal  Association  structures. 


Called  B 


Function 

Where  Described 

AssocOpen 

Section  2.20.1.5.1. 

AssocAttach 

Section  2.20.1.5.2. 

Table  2.20*71  AssocCreateFreeList  Information. 

2.20.1.24.2  AssocGrowFreeList 

AssocGrowFreeList  mallocs  more  nodes  (descriptor  parameters)  to  the  free  list  when  the 
bottom  of  the  stack  is  hit.  It  is  assumed  that  the  stack  is  empty  when  this  routine  is  called. 
The  function  call  is  AssocGrowFreeList(handle).  Table  2.20-72  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 


Variable 


channel 


Return  Value 


Internal  Variables 


e 


register  int 


register  pointer  to 
AssocT  ransDescriptor 


register  pointer  to 
ChannelDescriptor 


inter  to  pointer  to  char 


Where  Typedef  Declared 


Standard  C  type. 


/simnet/libsrc/libassoc/assoc_l 

cl.h 


/simnet/libsrc/libassoc/assoc_l 

cl.h 


Standard  C  type. 


Return  Values 


Type 


int 


Meanin 


Didn’t  have  enough  memory 
to  create  list. 


Successful. 


Errors 

Error  Name 

Reason  for  Error 

ANOM EMORY 

Not  enough  memory  for  internal  Association  stnjctures 
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1  Called  By  I 

Function 

Where  Described 

AssocGetDescriptor 

Section  2.20.1.24.3. 

Table  2.20>72  AssocGrowFreeList  Information. 

2.20.1.24.3  AssocGetDescriptor 

AssocGetDescriptor  attempts  to  pop  a  node  off  the  stack.  If  the  stack  has  some  nodes,  the 
descriptor  is  returned.  If  you  are  at  the  bottom  of  the  free  list,  the  routine  first  tries  to  free 
nodes  from  the  response  hst  by  calling  AssocTimeOutOldResponses.  If 
AssocTimeOutOldResponses  is  unsuccessful  in  freeing  up  a  node,  AssocGrowFreeList  is 
called.  If  AssocGrowFreeList  is  unsuccessful.  Null  is  returned.  The  function  call  is 
AssocGetDescriptor(handle).  Table  2.20-73  describes  the  parameters  used  and  functions 
called  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

handle 

int 

Standard  C  type. 

I  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

td 

register  pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

channel 

register  pointer  to 
ChannelDescriptor 

/simnet/libsrc/libassoc/assoc_l 

cl.h 

I  Return  Values  I 

Return  Value 

Meaning 

Null 

pointer  to 

AssocT  ransDescriptor 

there  are  no  free  nodes 

td 

pointer  to 

AssocT  ransDescriptor 

address  of  the  free  list 
transaction  descriptor 

I  Calls  I 

Function 

Where  Described 

AssocTimeOutOldResponse 

Section  2.20.1.18.4. 

AssocGrowFreeList 

Section  2.20.1.24.2. 

I  Called  Bv  I 

Function 

Where  Described 

AssocSendT  ransact 

Section  2.20.1.4.1. 

AssocSendResponse 

Section  2.20.1.4.2. 

Table  2.20-73  AssocGetDescriptor  Information. 
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2.20.1.24.4  AssocFreeDescriptor 

AssocFreeDescriptor  pushes  a  node  onto  the  stack.  The  function  call  is 
AssocFreeDescriptor(handle,  td).  Table  2.20-74  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

handle 

int 

Standard  C  tvoe. 

td 

register  pointer  to 
AssocTransDescriptor 

/simnet/libsrc/libassoc/assoc  1 
cl.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

channel 

register  pointer  to 
ChannelDescriptor 

/simnet/libsrc/libassoc/assoc  ! 
cl.h 

1  Called  By  I 

Function 

Where  Described 

AssocSendT  ransact 

Section  2.20.1.4.1. 

AssocSendResoonse 

Section  2.20.1.4.2. 

AssocDeleteCachedRespons 

e 

Section  2.20.1.18.3. 

AssocDeleteT  ransaction 

Section  2.20.1.23.3. 

Table  2.20<74  AssocFreeDescriptor  Information. 

2.20.1.25  bucket.c 

/simnet/libsrc/libassoc/bucket.c 

bucket.c  contains  routines  to  maintain  bucket  lists  of  pending  transactions.  Transactions 
are  sorted  into  buckets  by  the  low  order  7  bits  of  their  transaction  ID,  resulting  in  the 
possibility  of  each  bucket  having  a  linked  list  of  transactions. 


2.20.1.25.1  AssocAddToBucket 

AssocAddToBucket  adds  a  transaction  to  a  bucket,  linking  it  to  any  other  transactions 
already  in  the  bucket.  The  function  call  is  AssocAddToBucket(td,  map,  mask).  Table 
2.20-75  describes  the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

td 

pointer  to 

AssocTransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

map 

pointer  to  pointer  to 
AssocTransDescriptor 

/simnet/libsrc/libassoc/assoc  1 
cl.h 

mask 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

bucket 

register  pointer  to  pointer  to 
AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assoc_l 

cl.h 
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1  Called  By  I 

Function 

Where  Described 

AssocCacheResponse 

Section  2.20.1.18.2. 

AssocAddT  ransaction 

Section  2.20.1.23.2. 

Table  2.20-75  AssocAddToBucket  Information. 


2.20.1.25.2  AssocDeleteFromBucket 

AssocDeleteFromBucket  removes  a  transaction  from  a  bucket,  maintaining  any  links  within 
the  bucket.  The  function  call  is  AssocDeleteFromBucket(td,  map,  mask).  Table  2.20-76 
describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

td 

pointer  to 

AssocTransDescriptor 

/simnet/libsrc/libassoc/assoc_l 

cl.h 

map 

pointer  to  pointer  to 

AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assoc  1 
cl.h 

mask 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

bucket 

register  pointer  to  pointer  to 
AssocT  ransDescriptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

1  Called  By  1 

Function 

Where  Described 

AssocDeleteCachedRespons 

e 

Section  2.20.1.18.3. 

AssocDeleteT  ransaction 

Section  2.20.1.23.3. 

Table  2.20-76  AssocDeleteFromBucketInformation. 


2.20.1.25.3  AssocBucketLookup 

AssocBucketLookup  returns  the  bucket  of  the  transaction  defined  by  tid  and  who.  The 
function  call  is  AssocBucketLxx)kup(who,  tid,  map,  mask).  Table  2.20-77  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

who 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

tid 

Transaction  Identifier 

/si  mnet/commo  n/i  nclude/prot 
ocol/address.h 

map 

pointer  to  pointer  to 
AssocTransDescriptor 

/simnet/libsrc/libassoc/assoc_l 

cl.h 

Standard  C  t 
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1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

bucket 

register  pointer  to 
AssocTransDesciiptor 

/simnet/libsrc/libassoc/assocj 

cl.h 

Return  Values 

Return  Value 

Type 

Meaning 

Null 

pointer  to 

AssocT  ransDescriptor 

Transaction  not  in  bucket. 

buckel->transFront 

pointer  to 

AssocT  ransDescriptor 

Desired  transaction. 

Calls 

Function 

tVhere  Described 

ASSOC  ADDRESS  EQUAL 

Macro  defined  in  /simnet/libsrc/libassoc/assoc.h. 

Called  Bv 

Function 

Where  Described 

AssocFindResponse 

Section  2.20.1.18.5. 

AssocFi  ndTransactio  n 

Section  2.20.1.23.4. 

Table  2.20-77  AssocBucketLookup  Information. 

2.20.1.26  assoc. h 

/simnet/libsrc/libassoc/assoc.h 

assoc.h  contains  all  the  definitions  needed  by  the  outside  world  to  use  the  association  layer 
library.  Table  2.20-78  describes  the  variables  used  by  assoc.h. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

assoc  errno 

extern  int 

Standard  C  type. 

Table  2.20-78  assoc.h  Variable  Information. 

2.20.1.27  assoc_lcl.h 

/simnet/libsrc/libassoc/assocjcl.h 

assoc_lcl.h  contains  all  the  definitions  that  should  be  global  throughout  the  associatiaon 
layer  library  but  hidden  from  the  outside  world.  Table  2.20-79  describes  the  variables  used 
by  assoc_lcl.h. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

assocPaddingPDU 

extern  AssociationPDU 

/simnet/comnrion/include/prot 
ocol/p  assoc.h 

channelMap 

extern  pointer  to  array 
maxChannels  of 
ChannelDescriptor 

/simnet/libsrc/libassoc/assoc_l 

cl.h 

Table  2.20-79  assoc  Icl.h  Variable  Information. 
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2.20.1.28  defaults.h 

/simnet/libsrc/libassoc/defaults.h 

defaults.h  contains  the  default  values  for  the  assoc.def  file. 

2.20.1.29  AssocDef 

Assoc.def  is  a  generic  term  for  association  layer  parameter  files.  Any  number  of  parameter 
files  may  exist.  The  assocDef  parameter  to  the  AssocOpen  call  is  a  pointer  to  the  name  of 
the  parameter  file  to  use  for  that  channel.  Thus,  channel  defaults  are  set  independently  by 
using  different  parameter  files.  There  are  six  parameters  which  can  be  set  for  each 
association  channel.  They  are  described  in  Table  2.20-80. 


Parameter 

Description 

SITE 

Site  id  used  for  originator  site/host  pair.  Default  is 
siteirrelevant  (see 

/simnet/common/include/orotocol/address.h). 

HOST 

Host  id  used  for  originator  site/host  pair.  Default  is 
host  Irrelevant  (see 

/simnet/common/include/protocol/address.h). 

MAX_SUBSCRIPTIONS 

Maximum  number  of  multicast  addresses  to  which  this 
channel  may  subscribe.  Each  potential  subscription  costs 

8  bytes.  Default  is  64. 

INITlAL_DESCRIPTORS 

The  number  of  descriptors  allocated  for  transactions  and 
cached  responses  at  start-up.  If  this  number  is  exhausted, 
more  are  allocated.  Each  descriptor  costs  2628  bytes. 
Default  is  20. 

ADDITIONAL.DESCRIPTORS 

The  number  of  descriptors  allocated  additionally  each  time 
the  current  number  of  descriptors  is  exhausted.  The 
default  is  10. 

PROTOCOL_FAMILY 

The  protocol  family  to  which  this  channal  will  listen.  The 
default  is  ASSOC_FAMILY_SIMNET.  This  parameter  is 
specified  symbolically  as  one  of 

ASSOC  FAMILY  SIMNET.  ASSOC  FAMILY  DATA. 
ASSOC  FAMILY  VOICE  and  ASSOC  FAMILY  GT. 

Table  2.20-80  Assoc.def  Parameters. 

Parameters  are  specified,  one  per  line,  as  <parameter>  <parameter  value>.  Blank  lines, 
spaces,  tabs,  etc.  are  ignored  (except  that  <parameter>  and  <parameter  value>  must  be 
separated  by  one  or  more  blanks  or  tabs)>  Line  beginning  with  ‘#’  are  comments.  The 
parameter  reading  mechanism  is  case  insensitive. 

Here  is  an  example: 

#This  association  definition  file  describes  the  defaults: 

SITE  0 

HOST  0 

MAX_SUBSCRIPTIONS  64 

INITIAL.DESCRIPTORS  20 

ADOmONAL.DESCRIPTORS  10 
PROTOCOL_FAMILY  ASSOC_FAMILY_SIMNET 
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2.20.2  libnetif 

Libnetif  provides  a  high  performance  pathway  to  an  unreliable  datagram  transport  service 
such  as  Aat  provided  by  an  IEEE  802.3  network.  Libnetif  also  provides  several 
miscellaneous  functions  for  controlling  the  network  adapter  unit  The  miscellaneous 
functions  allow  applications  to  take  advantage  of  adapter  specific  capabilities  such  as 
multicast  addressing,  high  granularity  timers,  and  intelligent  on-board  processors. 

2.20.2.1  net_ctl.c 

/sunnet/libsrc/libnetif/net_ctl.c 

net_clt.c  contains  routines  used  to  perform  control  functions  on  the  network  interface. 

2.20.2.1.1  net_alive 

net_alive  probes  the  network  interface  referenced  by  the  descriptor,  h ,  to  determine 
whether  it  is  alive.  Success  means  that  the  code  loaded  onto  the  network  card  is  running. 
Failure  means  that  the  code  has  died  and  is  not  running.  The  function  call  is  net_alive(h). 
Table  2.20-81  describes  the  parameters  used,  return  values  and  possible  errors  generated 
by  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

network  interface  doesn’t 
respond,  errno  set  to  indicate 
error 

0 

int 

successful 

I  Errors  I 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

Network  interface  did  not  respond. 

I  Calls  I 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h 

net  access 

Section  2.20.2.20.1. 

I  Called  By  I 

Function 

Where  Described 

open  cmc 

Section  2.20.2.10.4. 

Table  2.20-81  net  alive  Information. 


798 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.20.2.1.2 


net  res 


net_res  resets  the  network  interface  controller  specified  by  descriptor  h.  The  interface 
controller  is  initialized  to  its  power-up  condition.  The  function  call  is  net_res(h).  Table 
2.20-82  describes  the  parameters  used,  return  values  and  possible  errors  generated  by 
using  this  function. 


I 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

h 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

operation  failed,  ermo  set  to 
indicate  error 

0 

int 

successful 

I  Errors  I 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

I  Calls  I 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h 

net  access 

Section  2.20.2.20.1. 

Table  2.20*82  net^res  Information. 

2.20.2.1.3  net_settimeout 

net_settimeout  is  called  to  specify  a  timeout  of  value  seconds  for  net_rccvs  and  nct_sends 
to  the  network  interface  specified  by  h.  The  default  condition  is  no  timeout.  A  timeout 
value  of  0  will  cause  no  timeout.  TTie  function  call  is  net_settimeout(h,  value).  Table  2.20- 
83  describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

value 

int 

Standard  C  type. 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

operation  failed,  ermo  set  to 
indicate  error 

0 

int 

successful 

I  Errors  I 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 
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1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-83  net_settimeout  Information. 

2.20.2.1.4  netjocontrol 

netjocontrol  provides  a  mechanism  to  access  control  functions  provided  by  underlying 
network  interface.  It  arranges  for  sendsize  bytes  to  be  copied  to  the  network  interface  from 
buffer  sendbirf  and  then  fcM"  recvsize  bytes  to  be  copied  to  buffer  recvbuf  from  the  network 
interface.  The  contents  of  the  buffers  are  I/O  control  functicHi  specific.  The  function  call  is 
net_iocontrol(h,  sendbuf,  sendsize,  recvbuf,  recvsize).  Table  2.20-84  describes  the 
parameters  us^,  errors  returned  and  functions  called  using  this  function  with  a  Butterfly. 
Table  2.20-85  describes  the  parameters  used,  errtx's  returned  and  functions  called  using 
this  function  with  any  other  computer. 


1  Parameters  | 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

h 

int 

Standard  C  type. 

sendbuf 

Dointer  to  char 

Standard  C  type. 

sendsize 

int 

Standard  C  tvpe. 

recvbuf 

pointer  to  char 

Standard  C  type. 

recvsize 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

np 

register  pointer  to  stnjct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

ret 

int 

Standard  C  type. 

rbuf 

pointer  to  char 

Standard  C  type. 

rbufoid 

OID 

sbuf 

pointer  to  char 

Standard  C  type. 

sbufoid 

OID 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

ret 

int 

0  if  successlui  -1  if  not 
successful 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20  1 

Table  2.20-84  Butterfly  neMocontrol  Information. 
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1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

h 

int 

Standard  C  type. 

sendbuf 

pointer  to  char 

Standard  C  type. 

sendsize 

int 

Standard  C  type. 

recvbuf 

pointer  to  char 

Standard  C  type. 

recvsize 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Tvpe 

Where  Tvpedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

ret 

int 

Standard  C  type. 

ara 

struct  enpaccess  ara 

enparq.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

ret 

int 

0  if  successful.  -1  if  not 
successful. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-85  Other  net  iocontrol  Information. 


2.20.2.1.5  net_nopened 

net_nopened  returns  the  number  of  times  the  interface  has  been  opened.  This  function  will 
only  work  on  a  MassComp  computer.  Other  computers  will  only  return  -1.  The  function 
call  is  net_nopened(h).  Table  2.20-86  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameter 


Parameters 


Where  Tvoedef  Declared 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

id 

int 

Standard  C  type. 

struct  shmid  ds 


Return  Value 

Type 

-1 

int 

buf.shm_nattch 

int 

Meanin 


Unsuccessful  or  computer 
other  than  Masscomo  used. 


Number  of  thimes  interface 
uhas  been  opened. 
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1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-86  net_nopened  Information. 

2.20.2.1.6  neMoopback 

net_loopback  turns  the  loopback  of  packets  on  and  off.  If  flag  is  1,  packets  are  looped.  If 
flag  is  0,  they  are  not  looped  The  default  condition  after  initialization  is  that  packets  are 
not  looped,  arg  is  only  used  if  SIMBFLY  is  NOT  defined  The  function  call  is 
net_loopback(h,  flag).  Table  2.20-87  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

fiaa 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
netlib  Db 

/simnet/libsrc/libnetif/libnet.h 

ret 

int 

Standard  C  type. 

command 

int 

Standard  C  type. 

arq 

struct  enoaccess  arq 

enparq.h 

1  Return  Values  I 

Return  Value 

Meaning 

ret 

int 

0  if  successful.  -1  if  not 
successful. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-87  neMoopback  Information. 

2.20.2.2  net_addr.c 

/simnef/libsrc/libnetif/net_addr.c 

2.20.2.2.1  net_addr_compare 

net_addr_compare  is  an  address  manipulation  routine.  It  compares  the  two 
NetworkAddresses  al  and  a2  and  returns  an  indication  of  whether  thay  are  equal  or  not. 
The  function  call  i«  net_addr_compare(al,  a2).  Table  2.20-88  describes  the  parameters 
used  and  return  values  generated  by  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

al 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

a2 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

FALSE 

int 

NetworkAddressess  are  not 
equal. 

TRUE 

int 

NetworkAddresses  are  equal. 

Table  2.20-88  net_addr_coinpare  Information. 
2.20.2.2.2  net  addr  bin  to  str 


net_addr_bin_to_str  converts  the  NetworkAddress  p  into  a  null  terminated  string  which  is 
returned  to  s.  s  must  point  to  a  buffer  at  least  13  bytes  long  to  accomodate  the  string 
generated  by  net_addr_bin_to_str.  The  routine  always  succeeds  so  there  is  no  return  value. 
The  function  call  is  net_addr_bin_to_str(p,  s).  Table  2.20-89  describes  the  parameters 
used  by  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

P 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

s 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

i 

int 

Standard  C  lype. 

Table  2.20-89  net_addr_bin_to_str  Information. 

2.20.2.2.3  net_addr_str_to_bin 

net_addr_str_to_bin  converts  the  string  s  into  a  NetworkAddress  in  p.  The  function  call  is 
net_addr_bin_to_str(p,  s).  Table  2.20-90  describes  the  parameters  used  and  return  values 
generated  by  using  this  function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

P 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

s 

pointer  to  char 

Standard  C  type. 

I  I 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

X 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

int 

String  address  did  not  have 
exactly  12  hex  digits.  Address 
is  all  Os. 

TRUE 

int 

String  address  had  exactly  12 
hex  digits. 

Table  2.20-90  net_addr_str_to_bin  Information. 

2.20.2.2.4  net_getaddr 

net_getaddr  gets  the  network  address  of  the  interface  specified  by  the  descriptor  h  to  the 
NetworkAddress  p.  It  returns  an  indication  of  success  or  failure.  The  function  call  is 
net.^etaddr(h,  p).  Table  2.20-91  describes  the  parameters  used,  return  values  and  possible 
errors  generated  by  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

P 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-91  net  getaddr  Information. 
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2.20.2.2.5 


net  zeroaddr 


net_2eroaddr  puts  a  zero  address  into  the  NetworkAddress  p.  The  routine  always  succeeds 
so  there  is  no  return  value.  The  function  call  is  net_zeroaddr(p).  Table  2.20-92  describes 
the  parameters  used  by  this  function. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

P 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

Table  2.20*92  net_zeroaddr  Information. 
2.20.2.2.6  net  addr  format  convert 


net_addr_fonnat_conven  converts  forniat  “XXXXXXXXXXXX”,p7,  to  “YY  YY  YY 
YY  YY  YY”,p2.  The  function  call  is  net_addr_format_convert(pl,  p2).  Table  2.20-93 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

P1 

register  pointer  to  char 

Standard  C  tvpe. 

P2 _ 

register  pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  int 

Standard  C  type. 

Table  2.20-93  net_addr_format_convertlnformation. 


2.20.2.3  net_clos.c 
/simnet/libsrc/Iibnetif/net_clos.c 
2.20.2.3.1  net_close 

net_close  closes  the  access  to  the  network  interface  specified  by  descriptor  h.  It  should  be 
called  prior  to  exiting.  The  function  call  is  net_close(h).  Table  2.20-94  describes  the 
parameters  used,  return  values  and  possible  errors  generated  by  using  this  function  with  a 
Butterfly.  Table  2.20-95  describes  the  parameters  used,  return  values  and  possible  errors 
generat^  by  using  this  function  with  a  MassComp.  Table  2.20-96  describes  the 
parameters  used,  return  values  and  possible  errors  generated  by  using  this  function  with  a 
Sun  or  a  MIPS. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

I  i 
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Internal  Variables 

Variable 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

Standard  C  t 


Return  Value 


ret 


Return  Values 


Meaning 


0  if  Successful.  -1  if  not 
successful. 


Error  Name 


EBADF 


Errors 


Reason  for  Error 


Not  a  valid  descriptor. 


Function 


CHECK  HANDLE 


Calls 


Where  Described 


Macro  defined  in  /simneUlibsrc/libnetif/libnet.h. 


Table  2.20-94  Butterfly  net_cIose  Information. 


Parameter 


Variable 


np 


Return  Value 


ret 


Error  Name 


EBADF 


Parameters 


Internal  Variables 


e 


register  pointer  to  struct 
netlib  pb 


mt 


IDT:! 


Where  Tvoedef  Declared 


Standard  C  t 


Where  Tvpedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Standard  C  type. 


Return  Values 


Type 


int 


Meaning 


0  if  successlul.  -1  if  not 
successful. 


Errors 


Reason  for  Error 


Not  a  valid  descriptor. 


Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

XXX  CLOSE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

detachshm 

Section  2. 6.5.2. 1  in  the  Vehicles  CSCI. 

Table  2.20-95  MassComp  net  close  Information. 
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Parameter 


Parameters 


Where  Tvpedef  Declared 


Standard  C  t 


Internal  Variables 

Variable 

Where  Tvoedef  Declared 

np 

register  pointer  to  ^ruct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

Standard  C  t 


Return  Value 


ret 


Return  Values 


Meanin 


0  if  successful.  -1  if  not 
successful. 


Error  Name 


EBADF 


Errors 


Reason  for  Error 


Not  a  valid  descnptor. 


Function 


CHECK  HANDLE 


XXX  CLOSE 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Table  2.20>96  Sun  and  MIPS  net  close  Information. 


2.20.2.4  net_flus.c 

/simnet/libsrc/libnetif/net_flus.i 


2.20.2.4.1  net  flush 


net_flush  flushes  all  packets  from  the  receive  and/or  transmit  queues  for  the  network 
interface  specified  by  descriptor  h.  The  card  must  be  running  (reference  net_norm  in 
Section  2.20.2.7.1)  before  this  call  can  be  made,  flags  is  a  bit  mask  that  selects  whether 
the  receive  queue  (NETFLUSHRCV)  or  the  transmit  queue  (NETFLUSHXMT)  or  both 
(NETFLUSHRCV  I  NETFLUSHXMT)  are  flushed.  An  indication  of  success  or  failure  is 
returned.  The  calls  to  Wait_DualQ()  and  Unlock_Dual(3()  are  only  made  if  SIMBFLY  is 
defined.  The  function  call  is  net_flush(h,  flags).  Table  2.20-97  describes  the  parameters 
used,  return  values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

flags 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Flush  unsuccessful,  errno  set 
to  indicate  error. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

Network  interface  did  not  respond. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Wait  DualQ 

net  access 

Section  2.20.2.20.1. 

SETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Unlock  DualQ 

Table  2.20-97  net_flush  Information. 

2.20.2.5  net_stat.c 

/simnet/libsrc/libnetif/net_stat.c 


2.20.2.5.1  net_get_statistic$ 

net_get_statistics  gets  the  accumlated  statistics  from  the  network  interface  specified  by 
descriptor  h  to  the  array  stats.  The  following  statistics  are  returned: 


successful  transmissions 
multiple  retries  reported 
single  retries  reported 
retry  failure  reported 

(check  cable) 

deferrals  reported 
buffer  errors 
silo  underruns 
late  collisions 

(check  cable) 

carrier  losses 

(check  cable) 

babbling  transmitter  errors 
collisions  errors 
memory  errors 
packets  received 
missed  packet  reported 

CRC  errors  reported 

(check  cable) 

framing  errors 

(check  cable) 

silo  overruns 
stp  bit  missing 
enp  bit  missing 
lance  errors 
non-SIMNET  packets 
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The  “check  cable”  annotation  indicates  a  potential  cable  fault  if  the  associated  statistic  is 
increasing.  The  function  call  is  net_get_statistics(h,  stats).  The  variable  arg  is  only  used  if 
MIPS  is  defined.  Table  2.20-98  describes  the  parameters  used,  return  values  and  possible 
errors  generated  by  using  this  function. 


Parameter 


stats 


Parameters 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  t 


Variable 


Internal  Variables 


e 


struct  enpaccess  a 


lEnn 


Where  Tvoedef  Declared 


Return  Value 


-1 


Type 

Meaning 

int 

operation  failed,  ermo  set  to 
indicate  error 

int 

successful 

Error  Name 


EBADF 


ElO 


Errors 


Reason  for  Error 


Not  a  valid  descriptor. 


The  network  interlace  did  not  respond. 


Function 


CHECK  HANDLE 


net  access 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Section  2.20.2.20.1. 


Called  B 


Function 

Where  Described 

net  print  statistics 

Section  2.20.2.5.4. 

Table  2.20-98  net_get_statistics  Information. 

2.20.2.5.2  net_zero_statistics 

net_zero_statistics  zeros  the  statistics  for  the  network  interface  specifed  by  descriptor  h. 
The  function  call  is  net_zero_statistics(h).  Table  2.20-99  describes  the  parameters  used, 
return  values  and  possible  errors  generated  by  using  this  function. 


Parameters 


Parameter 


Where  Typedef  Declared 


Standard  C  t 


Return  Values 


Return  Value 

Type 

Meaning 

-1 

int 

operation  failed,  errno  set  to 
indicate  error 

0 

int 

successful 
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1  Errors  I 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/tibnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20*99  net  zero  statistics  Information. 


2.20.2.5.3  net_stat_string 

net_stat_string  returns  a  null  terminated  string  of  length  40  characters  (padded  with  spaces) 
to  bi4  far  statistic  number  stat.  If  no  string  is  available  for  the  statistic  stat,  a  zero  length 
string  is  returned.  Section  2.20.2.5.1,  net_get_statistics,  for  a  table  of  available  statistics. 
The  function  call  is  net_stat_string(stat,  buf).  Table  2.20-100  describes  the  parameters 
used,  return  values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

stat 

int 

Standard  C  type. 

buf 

pointer  to  char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

-1 

int 

operation  failed,  errno  set  to 
indicate  error 

0 

int 

successful 

1  Errors  1 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

1  Called  By  I 

Function 

Where  Described 

net  print  statistics 

Section  2.20.2.5.4. 

Table  2.20-100  net_stat_string  Information. 


2.20.2.5.4  net_print_statistics 

net_print_statistics  prints  the  statistics  in  the  format  of  the  table  in  the  description  of 
net_get_statistics  above.  The  function  call  is  net_print_statistics(h).  Table  2.20-101 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 
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1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

stats 

array  N  STATS  ot  long 

Standard  C  type. 

str 

array  60  of  char 

Standard  C  type. 

i 

register  int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

operation  failed,  errno  set  to 
indicate  error 

0 

int 

successful 

I  Errors  I 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

I  Calls  I 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  oet  statistics 

Section  2.20.2.5.1. 

net  stat  string 

Section  2.20.2.5.3. 

Table  2.20-101  net_print_statistics  Information. 

2.20.2.6  net_info.c 

/sininet/libsrc/libnetif/net_info.c 

2.20.2.6.1  net_hostbuf_info 

net_hostbuf_info  obtains  a  pointer  to  and  the  size  in  bytes  of  the  hostbuf.  The  pointer  is 
returned  in  pbufptr  and  the  size  is  returned  in  pbitfsize.  This  memory  block  is  guaranteed 
to  be  aligned  on  a  short  boundary.  The  hostbuf  is  a  segment  of  memory  resident  on  the 
network  card  that  is  accessible  to  an  application  running  on  the  host  as  well  as  to  code 
mnning  on  the  network  card.  It  may  be  used  to  transfer  parameters  between  an  application 
and  filtering  code,  for  example,  running  on  the  network  card.  The  host  should  avoid  heavy 
access  to  this  region  as  it  will  consume  bus  bandwidth  on  the  network  card.  The  function 
call  is  net_hostbuf_info(h,  pbufptr,  pbufsize).  Table  2.20-102  describes  the  parameters 
used,  return  values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

pbufptr 

pointer  to  pointer  to  char 

Standard  C  type. 

pbufsize 

pointer  to  int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

bufsf2l 

int 

Standard  C  type. 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriotor. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-102  net_hostbuf_info  Information. 

2.20.2.6.2  net_sharebuf_info 

net_sharebuf_info  is  called  to  obtain  a  pointer  to  and  the  size  in  bytes  of  the  shared  buffer, 
which  is  a  segment  of  memory  resident  in  the  host  that  the  network  card  and  an  application 
running  on  the  host  can  access.  The  pointer  is  returned  into  pbujptr  and  the  size  in 
pbitfsize.  This  memory  segment  is  guaranteed  to  be  aligned  on  a  long  boundary.  The 
function  call  is  net_sharebuf_info(h,  pbufptr,  pbufsize).  Table  2.20-103  describes  the 
parameters  used,  return  values  and  possible  errors  generated  by  using  this  function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type 

pbufptr 

pointer  to  pointer  to  char 

Standard  C  type. 

pbufsize 

pointer  to  int 

Standard  C  type. 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

1  Errors  I 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnef.h. 

Table  2.20-103  net  sharebuMnfo  Information. 
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2.20.2.6.3  net_bufs 

net_bufs  returns  the  number  of  transmit  and  receive  buffers  available  in  the  underlying 
network  interface,  pxmtbus  and  prcvbufs  are  pointers  to  where  to  return  the  number  of 
transmit  and  receive  buffers.  The  function  call  is  net_bufs(h,  pxmtbufs,  prcvbufs).  Table 
2.20-104  describes  the  parameters  used  and  functicHis  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

pxmtbufs 

pointer  to  int 

Standard  C  type. 

prcvbufs 

pointer  to  int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

bufr2i 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

I  Calls  I 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-104  net_bufs  Information. 
2.20.2.6.4  neMnterface_type 


net_interface_type  returns  the  interface  type  for  the  handle,  h  The  current  ty]>*«:  are 
N1F_TYPE_CMC  and  NIF_TYPE_147.  The  function  call  is  net_interface_typ>e(h).  Table 
2.20-105  describes  the  parameters  used  and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

nbp[h].type 

int 

Interface  type  for  handle. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-105  net_interface_type  Information. 
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2.20.2.6.5  net_syserror_info 


net_syserror_info  gets  a  pointer  to  the  character  array  of  system  errors,  perr,  and  also 
returns  the  number  of  the  system  errors,  p  juun.  The  function  call  is 
net_syserrOT_info(h,perr,p_num).  Table  2.20-106  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

Derr 

pointer  to  pointer  to  char 

mil  iiiiit'i  1^— 

p  num 

pointer  to  int 

Standard  C  type.  1 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

Always  returned. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-106  net_syserror_info  Information. 

2.20.2.6.6  net_version 

net_version  returns  a  null  terminated  string  that  contains  the  version  of  the  underlying 
network  interface  software,  version  is  a  pointer  to  the  buffer  into  which  the  version  string 
is  returned,  version  size  is  the  size  of  the  buffer  pointed  to  by  version.  The  functioa  call 
is  net_version(h,  version,  version_size).  Table  2.20-107  describes  the  parameters  used, 
and  functions  called  using  this  function  with  a  Butterfly.  Table  2.20-108  describes  the 
parameters  used  and  functions  called  using  this  function  with  all  other  computers. 


i  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

version 

pointer  to  char 

Standard  C  type. 

version  size 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

np 

pointer  to  struct  netlib  pb 

/simnet/libsrc/libnetif/libnet  h 

ret 

int 

Standard  C  type. 

buf 

pointer  to  char 

Standard  C  type. 

bufoid 

OID 

1  Return  Values  1 

Return  Value 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 
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1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/iibnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-107  Butterfly  net_version  Information. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

version 

pointer  to  char 

Standard  C  type. 

version  size 

int 

Standard  C  type. 

internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

np 

pointer  to  struct  netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

ret 

int 

Standard  C  type. 

ara 

struct  enpaccess  ara 

enpara.h 

I  |i|li  I  I  I  II  I  ■  II I  i— 

char 

Standard  C  type. 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-108  Other  net_version  Information. 

2.20.2.7  net_mode.c 

/sininet/libsrc/libnetif/net_mode.c 

2.20.2.7.1  net_norm 

net_norm  starts  the  network  interface  specified  by  descriptor  in  the  nonnal  mode  of 
operation.  The  ethemet  address  of  the  interface  is  set  to  na  upon  the  first  invocation  of  the 
call.  The  argument  na  must  be  a  valid  pointer  for  subsequent  calls  by  the  data  will  be 
ignored.  The  function  call  is  net_norm(h,  na).  Table  2.20-109  describes  the  parameters 
used,  return  values  and  possibl"  errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

na 

pointer  to  NetworkAddress 

/si  mnet/Ubsrc/li  bnetif /network . 
h 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

Calls 

Function 

Where  Described 

do  mode  cmd 

Section  2.20.2.7.5. 

Table  2.20-109  net_norin  Information. 

2.20.2.7.2  neMntloop 

net_intloop  starts  the  network  interface  specified  by  descriptor  /i  in  the  internal  loopback 
mode  of  operation.  The  ethemet  address  of  the  interface  is  set  to  na  upon  the  first 
invocation  of  the  call.  The  argument  na  must  be  a  valid  pointer  for  subsequent  calls  by  the 
data  will  be  ignored.  The  function  call  is  net_intloop(h,  na).  Table  2.20-1 10  describes  the 
parameters  used,  return  values  and  possible  errors  generated  by  using  this  function. 


1  Parameters 

Parameter 

Where  Typedet  Deciared 

h 

int 

Standard  C  type. 

na 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

Calls 

Function 

Where  Described 

do  mode  cmd 

Section  2.20.2.7.5. 

Table  2.20-110  net  intloop  Informalion. 
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2.20.2.7.3  net_extloop 

net_extloop  starts  the  network  interface  specified  by  descriptor  h  in  the  external  loopback 
mode  of  operation.  The  ethemet  address  of  the  interface  is  set  to  ^  upon  the  first 
invocation  of  the  call.  The  argument  na  must  be  a  valid  pointer  fix'  subsequent  calls  by  the 
data  will  be  ignored.  The  funcuon  call  is  net_extloop(h,  na).  Table  2.20-1 1 1  describes  the 
parameters  used,  return  values  and  possible  errcx^  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

na 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

■ 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

Calls 

Function 

Where  Described 

do  mode  cmd 

Section  2.20.2.7.5. 

Table  2.20-1 11  net_extloop  Information. 

2.20.2.7.4  net_prom 

net_prom  starts  the  network  interface  specified  by  descriptor  h  in  the  promicuous  mode  of 
operation.  The  ethemet  address  of  the  interface  is  set  to  na  upon  the  l^t  invocation  of  the 
call.  The  argument  na  must  be  a  valid  pointer  for  subsequent  calls  by  the  data  will  be 
ignored.  The  function  call  is  net_prom(h,  na).  Table  2.20-1 12  describes  the  parameters 
used,  return  values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

na 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

1  Return  Values  1 

Return  Value 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 
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1  Errors  1 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

Calls 

Function 

Where  Described 

do  mode  cmd 

Section  2.20.2.7.5. 

Table  2.20-112  net_proin  Information. 


2.20.2.7.5  do_mode_cmd 

do_nKxie_cmd  is  an  internal  library  function  for  setting  the  mode  of  the  underlying  network 
interface,  mode  is  a  mode  word  (one  of  NORMMODE,  EXTLMODE,  INTLMODE, 
PROMMODE  -  normal,  external  loopback,  internal  loopback  and  promiscuous  modes, 
respectively),  A  is  a  descriptor,  naisa  pointer  to  the  network  address  to  which  the  Ethernet 
address  of  the  network  interface  is  set.  The  function  call  is  do_nKxle_cmd(mode,  h,  na). 
Table  2.20-1 13  describes  the  parameters  used,  errors  returned  and  functions  called  using 
this  function. 


Parameter 


mode 


Parameters 


E2T! 


pointer  to  NetworkAddress 


Where  TvDedef  Declared 


Standard  C  type. 


Standard  C  type. 


/simnet/libsrc/libnetif/network. 


Variable 


Internal  Variables 


e 


Where  Tvpedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Standard  C  type. 


Return  Value 


-1 


ret 


Return  Values 


Type 


int 


int 


Meaning 


Unsuccessful. 


Successful. 


Function 


CHECK  HANDLE 


do  mode  cmd  cmc 


do  mode  cmd  147 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Section  2.20.2.7.6. 


Section  2.20.2.7.7. 


Function 


net  norm 


net  intloo 


net  extioo 


net  prom 


Called  B 


Where  Described 


Section  2.20.2.7.1. 


Section  2.20.2.7.2. 


Section  2.20.2.7.3. 


Section  2.20.2.7.4. 


Table  2.20-113  do  mode  cmd  Information. 
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2.20.2.7.6 


do  mode  cmd  cmc 


do_mode_cind_cmc  is  the  cmc  card  specific  handler  for  setting  the  mode. 
do_mode_cmd_147  is  the  MVME147  card  specific  handler  for  setting  the  mode,  args  is 
only  used  if  SIMBFLY  is  NOT  defined.The  function  call  is  do_mode_cmd_cmc(mode,  h, 
na,  np).  Table  2.20-1 14  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mode 

int 

Standard  C  type. 

h 

int 

Standard  C  tvoe. 

na 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

ne 

1  lliilli  ■iliihlilillll  M 

/simnet/libsrc/libnetif/libnet.h 

1  Internal  Variables  1 

■  Variable  1 

1  Where  Typedef  Declared  I 

struct  enpmn  arq 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

1  Calls  1 

Function 

Where  Described 

SETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Rinqsize  in  chars 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

net  access 

Section  2.20.2.20.1. 

1  Called  Bv  1 

Function 

Where  Described 

do  mode  cmd 

Section  2.20.2.7.5. 

Table  2.20-114  do_mode_cmd_cmc  Information. 
2.20.2.7.7  do_mode_cmd_147 

do_mode_cmd_147  is  not  currently  supported  on  any  computer  used  in  SIMNET.  The 
function  call  is  do_mode_cmd_147(m^e,  h,  na,  np).  Table  2.20-1 15  describes  the 
parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

mode 

int 

Standard  C  type. 

h 

int 

Standard  C  type. 

na 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

_ 

pointer  to  struct  netlib  pb 

/simnet/libsrc/libnetif/libnet.h 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

ret 

int 

Always  -1 . 

Called  By 

Function 

Where  Described 

do  mode  cmd 

Section  2.20.2.7.5. 

Table  2.20-115  do_mode_cind_147  Information. 

2.20.2.8  net_time.c 

/sininei/libsrc/libneti^net_time.c 

net_time.c  ccmtains  routines  to  access  the  CMC  card  timer. 

2.20.2.8.1  net_gettime 

net_gettime  obtains  the  current  value  of  the  31  bit  timer  maintained  by  the  network  interface 
specified  by  descriptor  h.  The  timer  is  incremented  every  998.26  microseconds.  The 
function  call  is  net_gettime(h).  Table  2.20-1 16  describes  the  parameters  used,  return 
values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

ret 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

ret 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriotor. 

ElO 

The  network  interface  did  not  respond. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/iibnet  h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-116  net_gettime  Information. 
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2.20.2.8.2 


net  settime 


net_settiine  sets  the  current  value  of  the  31  bit  timer  maintained  by  the  network  interface 
specified  by  descriptor  h.  The  timer  is  incremented  every  998.26  microseconds.  The 
functicHi  call  is  net_settime(h,  time).  Table  2.20-1 17  describes  the  parameters  used,  return 
values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

h 

int 

Standard  C  type. 

time 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Tvoedef  Declared 

ret 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

-1 

int 

Operation  failed,  ermo  set  to 
indicate  error. 

0 

int 

Successful. 

1  Errors  1 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-117  net_settime  Information. 

2.20.2.8.3  net_current_time 

net_current_time  returns  the  number  of  ticks  since  the  last  call  to  net_init_time  (Section 
2.20.2.8.4).  net_init_time  must  be  called  once  before  net_current_time  will  return  a 
meaningful  value.  If  it  is  not  called  for  a  bit  over  60  seconds,  it  loses  track  of  time,  as  the 
16-bit  timer  cycles.  While  this  is  not  a  fatal  error,  the  time  returned  by  net_cunent_time 
will  not  be  correct.  The  function  call  is  net_current_time(h).  Table  2.20-1 18  describes  the 
parameters  used,  return  values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

■  Parameter 

Type 

Where  Tvpedef  Declared 

bi _ _ _ 

int 

Standard  C  type. 

1  1 
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Variable 


dif 


cur  time 


np 


Internal  Variables 


e 


reaister  lo 


reaister  unsianed  ion 


register  pointer  to  struct 
netlib  pb 


int 


Where  Tvpedef  Declared 


Standard  C  t 


Standard  C  t 


/simnet/libsrc/libnetif/iibnet.h 


Standard  C  t 


Return  Value 


-1 


Return  Values 


Meanin 


Netwoi1<  interface  cannot  be 
closed,  ermo  set  to  indicate 
error. 


Successful. 


Error  Name 


EBADF 


EINVAL 


Errors 


Reason  for  Error 


Not  a  valid  descriptor. 


The  kernel  is  not  set  up  correctly  to  allow  the  timer  to  be 
mapped  in. 


Function 


CHECK  HANDLE 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Table  2.20*118  net_current_time  Information. 

2.20.2.8.4  iet_;rtit_time 

net_init_time  initializes  the  16-bit  timer  on  the  CMC  card.  This  timer  is  incremented  every 
998.26  microseconds.  net_init_time  must  be  called  once  before  net_current_time  is  used. 
The  function  call  is  net_init_time(h).  Table  2.20-119  describes  the  parameters  used,  return 
values  and  possible  errors  generated  by  using  this  function. 


Parameter 


h 


Parameters 


Where  Tvpedef  Declared 


Standard  C  type. 


Variable 


np 


Internal  Variables 


e 


register  pointer  to  struct 
netlib  pb 


int 


Where  Tvpedef  Declared 


/simnetyiibsrc/libnetif/libnet.h 


Standard  C  type. 


Return  Value 


Return  Values 


Type 


int 


Meanin 


Network  interface  cannot  be 
closed,  ermo  set  to  indicate 
error. 


Successful. 
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1  Errors  1 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

EINVAL 

The  kernel  is  not  set  up  correctly  to  allow  the  tinier  to  be 
mapped  in. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/iibnet.h. 

Table  2.20-119  net  init  time  Information. 


2.20.2.8.5  net_stomp_time 

net_stomp_time  directs  the  netwwk  interface  to  set  the  32  bit  timer  to  the  timestamp  value 
of  the  next  packet  (if  any)  in  the  transmit  queue.  This  call  has  no  effect  if  timestamping  is 
not  enabled.  It  is  useful  as  a  “fast  forward”  function  in  applications  that  need  to  replay 
timestamped  packets.  The  function  call  is  net_stomp_time(h).  Table  2.20-120  describes 
the  parameters  used,  return  values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

inf 

Operation  failed,  ermo  set  to 
indicate  error. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-120  net_stomp_time  Information. 
2.20.2.8.6  net  heartbeat 


net_heartbeat  returns  the  heartbeat  value.  The  function  call  is  net_heartbeat(h).  Table  2.20- 
121  describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

BBN  Systems  and  Technologies 


MCC  CSCI 


Variable 


np 


Internal  Variables 


register  pointer  to  stmct 
netlib  pb 


unsioned  short 


Where  Tvoedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Standard  C  t 


Return  Values 


Return  Value 


-1 


unsigned  int 


unsigned  int 


unsigned  int 


Meanin 


Unsuccessful.  Device  not 
mapped-in.  Error  code 
returned  in  errno. 


Unsuccessful. 


Heartbeat  value. 


Error  Name 


EINVAL 


Errors 


Reason  for  Error 


Heartbeat  not  maoced  in. 


Function 


CHECK  HANDLE 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Table  2.20-121  net_heartbeat  Information. 

2.20.2.8.7  net_devlce_base 

net_device_base  returns  the  base  of  the  mapped-in  device.  The  function  call  is 
net_device_base(h).  Table  2.20-122  descries  the  parameters  used,  errors  returned  and 
functions  called  using  this  function. 


Parameter 


Parameters 


Where  Typedef  Declared 


Standard  C  type. 


Internal  Variables 

Variable 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

Return  Value 


-1 


NULL 


ret 


Return  Values 


Type 


int 


Meaning 


Unsuccessful.  Device  not 
mapped-in.  Error  code 
returned  in  errno. 


Networx  interface  unknown  or 
unsupported. 


Base  of  the  mapped-in  device. 


Error  Name 


EINVAL 


Errors 


Reason  for  Error 


Device  not  mapped  in. 
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1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-122  net_device_base  Information. 

2.20.2.9  neMoad.c 

/simnet/libsrc/libnetifynet_load.c 

2.20.2.9.1  netjoad 

netjoad  copies  count  bytes  starting  fiom  bi^er  to  offset  bytes  from  the  start  of  memory  on 
the  network  interface.  The  function  call  is  netjoad^,  buffer,  count,  offset).  Table  2.20- 
123  describes  the  parameters  used,  return  values  and  possible  errcffs  generated  by  using 
this  function  with  a  Butterfly.  Table  2.20-124  descries  the  parameters  used,  return  v^ues 
and  possible  errors  generated  by  using  this  function  with  a  MassComp.  Table  2.20-125 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function  with  an  MSC.  Table  2.20-126  describes  the  parameters  used,  return  values  and 
possible  errors  generated  by  using  this  function  with  a  Sun.  Table  2.20-127  describes  the 
parameters  used,  return  values  and  possible  errors  generated  by  using  this  function  with  a 
MIPS. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  tvpe. 

buffer 

pointer  to  char 

Standard  C  tvpe. 

count 

int 

Standard  C  type. 

offset 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

np 

register  pointer  to  stoict 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

localbuf 

pointer  to  char 

Standard  C  type. 

localbufoid 

OID 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

1  1 
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Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Do  bt _ 

net  access  Section  2.20.2.20.1. 

Table  2.20-123  Butterfly  net_load  Information. 


1  Parameters 

Parameter 

Where  Tvpedef  Declared 

h 

int 

Standard  C  type. 

buffer 

pointer  to  char 

Standard  C  type. 

count 

int 

Standard  C  type. 

offset 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

nioaded 

int 

Standard  C  type. 

werr 

int 

Standard  C  type. 

1  Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

I  Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriotor. 

ElO 

The  network  interface  did  not  respond. 

I  Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

XXX  LSEEK 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

XXX  WRITE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-124  MassComp  net  load  Information. 
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Parameter 


buffer 


count 


offset 


Parametera 


Where  Tvpedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Return  Value 


Return  Values 


Meanin 


Always  returned. 


Error  Name 


EBADF 


ElO 


Errors 


Reason  for  Error 


Not  a  valid  descriptor. 


The  network  interface  did  not  respond. 


Function 


CHECK  HANDLE 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/iibnet.h. 


Table  2.20-125  MSC  net  load  Information. 


Parameter 


buffer 


count 


offset 


Parameters 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  t 


Return  Value 


-1 


Return  Values 


Meanin 


Operation  failed,  errno  set  to 
indicate  error. 


Successful. 


Error  Name 


EBADF 


ElO 


Errors 


Reason  for  Error 


Not  a  valid  descnptor. 


The  network  interface  did  not  respond. 


Function 


CHECK  HANDLE 


movebvtes 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Function  defined  in  libmove.  Section  2.21 .5. 


Table  2.20-126  Sun  net  load  Information. 
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Parameter 


Parameters 


butfer 


count 


offset 


MCC  CSCI 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Variable 


np 


Internal  Variables 


e 


register  pointer  to  struct 
netlib  ob 


int 


Where  Tvpedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Return  Values 


Return  Value 


-1 


Meanin 


int 

Operation  failed,  ermo  set  to 
indicate  error. 

int 

Successful. 

Error  Name 


EBADF 


ElO 


Errors 


Reason  for  Error 


Not  a  valid  descriotor. 


The  network  interface  did  not  respond. 


Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

XXX  LSEEK 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

XXX  WRITE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-127  MIPS  neMoad  Information. 

2.20.2.9.2  net_unload 

net_unload  copies  count  bytes  from  offset  bytes  from  the  start  of  the  memory  on  tlie 
network  interface  to  buffer.  The  function  call  is  net_unload(h,  buffer,  count ,  offset). 
Table  2.20-128  describes  the  parameters  used,  return  values  and  possible  errors  generated 
by  using  this  function  with  a  Butterfly.  Table  2.20-129  describes  the  parameters  used, 
return  values  and  possible  errors  generated  by  using  this  function  with  a  MassComp 
Table  2.20-130  describes  the  parameters  used,  return  values  and  possible  errors  generated 
by  using  this  function  with  a  Sun.  Table  2.20-131  describes  the  parameters  used,  return 
values  and  possible  errors  generated  by  using  this  function  with  an  MSC.  Table  2.20-132 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function  with  a  MIPS. 
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Parameter 


buffer 


count 


offset 


Parameters 


Where  Tvoedef  Declared 


Sianoard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Variable 


np 


localbuf 


localbufoid 


Internal  Variables 


register  pointer  to  stmct 
netlib  pb 


inter  to  char 


OID 


Where  Tvoedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Standard  C  t 


Return  Value 


-1 


Return  Values 


Meanin 


Operation  failed,  ermo  set  to 
indicate  error. 


Successful. 


Error  Name 


EBADF 


ElO 


Errors 


Reason  for  Error 


Not  a  valid  descriptor. 


The  network  interface  did  not  respond. 


Function 


CHECK  HANDLE 


net  access 


Do  bt 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Section  2.20.2.20.1. 


Parameter 


buffer 


count 


offset 


Parameters 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  t 


Variable 


np 


nunloaded 


rerr 


Internal  Variables 


e 


register  pointer  to  struct 
netlib  pb 


int 


int 


Where  Tvoedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Standard  C  type. 


Standard  C  type. 


Return  Value 

Type 

-1 

int 

0 

int 

Meanin 


Operation  failed,  errno  set  to 
indicate  error. 


Successful. 
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Error  Name 


EBADF 


ElO 


Errors 


Reason  for  Error 


Not  a  valid  descnptor. 


The  network  interface  did  not  respond. 


Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

XXX  LSEEK 

Macro  defined  in  /simnet/libsrc/iibnetif/libnet.h. 

XXX  READ 

Macro  defined  in  /simnet/libsrc/libnetit/libnet.h. 

Table  2.20-129  MassComp  net_unload  Information. 


Parameter 


buffer 


count 


offset 


Parameters 


Where  Tvoedef  Declared 


Standard  C  tvpe. 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

nunloaded 


rerr 


Standard  C  t 


Standard  C  type. 


Return  Value 


-1 


Return  Values 


Meanin 


Operation  failed,  errno  set  to 
indicate  error. 


Successful. 


Error  Name 


EBADF 


ElO 


Errors 


Reason  for  Error 


Not  a  valid  descriptor. 


The  network  interface  did  not  respond. 


Function 


CHECK  HANDLE 


XXX  LSEEK 


XXX  READ 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Macro  defined  in  /simnet/libsrc/libnetit/libnet.h. 


Table  2.20-130  Sun  net  unload  Information. 
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Parameter 


buffer 


count 


offset 


Parameters 


Where  Tvpedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Return  Value 


Return  Values 


Meanin 


Always  returned. 


Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

Function 


CHECK  HANDLE 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Table  2.20-131  MSC  net  unload  Information. 
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1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

XXX  LSEEK 

Macro  defined  in  /simnet/tibsrc/iibnetif/iibnet.h. 

XXX  READ 

Macro  defined  in  /simnet/libsrc/iibnetif/libnet.h. 

Table  2.20-132  MIPS  net_unload  Information. 

2.20.2.10  net_open.c 

/siinnet/libsrc^bnetij7net_open.c 

2.20.2.10.1  net_open 

net_open  opens  an  access  path  to  the  network  interface,  path  speciBes  the  network 
interface  to  open,  flags  specifies  options  to  be  active  for  subsequent  accesses  to  the 
network  interface.  Currently,  the  only  flag  defined  is  NETINIT,  which  should  be  used 
only  by  ringstart.  Otherwise,  should  be  0.  The  third  parameter  is  only  necessary  if 
NETINIT  is  set.  The  net_info_block  contains  default  information  for  the  rings  and  is  used 
only  during  system  intialization  by  the  network  daemon.  This  routine  will  test  to  determine 
whether  the  network  interface  card  is  alive  and  will  fail  if  it  does  not  respond.  The  function 
call  is  net_open(path,  flags,  nib).  Table  2.20-133  describes  the  parameters  used,  return 
values  and  possible  errors  generated  by  using  this  function  with  a  Butterfly.  Table 
2.20-134  describes  the  parameters  used,  return  values  and  possible  errors  generated  by 
using  this  function  with  any  other  computer. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

svr 

pointer  to  char 

Standard  C  type 

flags 

int 

Standard  C  type 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

mb  mr 

MBMAPREGION 

Standard  C  type. 

h 

int 

Standard  C  type. 

s 

array  120  of  char 

Standard  C  type. 

P 

pointer  to  char 

Standard  C  type. 

np 

register  pointer  to  struct 
netiib  pb 

/simnet/libsrc/libnetit/libnet.h 

i 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

h 

int 

Successful.  Valid  network 
interface  descriptor  for 
subsequent  calls 

I  I 

I 
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Error  Name 


ENODEV 


EMFILE 


ElO 


Errors 


Reason  for  Error 


The  network  interface  does  not  exist. 


Too  many  network  interfaces  ooen. 


The  network  interface  did  not  respond. 


Function 


et  device  number 


msm 


net  access 


Calls 


Where  Described 


Section  2.20.2.10.7. 


Section  2.20.2.10.6. 


Section  2.20.2.20.1. 


Table  2.20-133  Butterfly  net_open  Information. 
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2.20.2.10.2  net_get_parameters 

net_get_parameters  gets  the  current  network  parameters.  These  include  such  things  as  the 
number  of  ring  elements  and  size  of  ring  elements,  and  various  memory  keys.  If  the  flag  is 
FALSE,  the  parameters  are  taken  from  die  process’s  information  block.  If  the  flag  is 
TRUE,  the  parameters  are  obtained  from  the  driver  directly.  Normally,  these  should  be 
identical,  but  they  may  not  be  if  net_open  (Section  2.20.2.10.1)  was  called  with  the 
NETINTT  flag.  The  function  call  is  net_get_parameterss(h,  nib,  flag).  Table  2.20-135 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

h 

int 

Standard  C  type. 

nib 

pointer  to  struct 
net  info  block 

/simnet/libsrc/libnetif/network. 

h. 

flaa 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

1  Errors  1 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/iibnet.h. 

net  access 

Section  2.20.2.20.1. 

1  Called  By  1 

Function 

Where  Described 

open  cmc 

Section  2.20.2.10.4. 

Table  2.20-135  net_get_parameters  Information. 
2.20.2.10.3  net_set_parameterss 

net_set_parameters  copies  the  passed  parameter  block  to  the  driver  (flag  is  TRUE)  or  the 
per-process  parameter  block  (flag  is  FALSE).  net_set_parameters  will  rarely  be  used 
except  in  ringstan.  The  function  call  is  net_set_parameters(h,  nib,  flag).  Table  2.20-136 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 
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Parameters 


Parameter 


int 


pointer  to  struct 
net  info  block 


int 


Where  Tvpedef  Declared 


Standard  C  t 


/simnet/Ubsrc/libnetif/network. 

h 


Standard  C  t 


Return  Values 


Return  Value 


-1 


Meanin 


Operation  failed,  errno  set  to 
indicate  error. 


Successful. 


Error  Name 


EBADF 


Errors 


Reason  for  Error 


Not  a  valid  descriptor. 


Function 


CHECK  HANDLE 


net  access 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Section  2.20.2.20.1. 


Table  2.20-136  net_set_parameters  Information. 


2.20.2.10.4 


open_cmc 


open_cmc  is  the  open  handler  for  the  cmc  card.  It  is  an  internal  library  function,  device 
and  flags  are  the  same  as  for  net_open.  nib  is  a  pointer  to  a  network  interface  block;  h  is  a 
descriptor,  np  is  a  pointer  to  a  data  structure  that  is  internal  to  the  library  and  controls  the 
access.  The  function  call  is  open_cmc(device,  flags,  nib,  h,  np).  Table  2.20-137 
describes  the  parameters  used  and  functions  called  using  this  function. 
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Calls 

Function 

Where  Described 

net  access 

Section  2.20.2.20.1. 

et  device  number 


net  alive 


net  aet  parameters 


et  locks 


map  buffers 


map  en 


unmap  buffers 


unoet  locks 


XXX  CLOSE 


Section  2.20.2.10.7. 


Section  2.20.2.1.1. 


Section  2.20.2.10.2. 


Section  2.20.2.21.1. 


Section  2.20.2.21.2. 


Section  2.20.2.21.3. 


Section  2.20.2.21.5. 


Section  2.20.2.21.6. 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Function 


net  open 


2.20.2.10.5 


Called  B 


Where  Described 


Section  2.20.2.10.1. 


Table  2.20*137  open_cmc  Information. 
open_147 


open_147  is  not  currendy  supported  by  any  computer  used  by  SIMNET.  The  function  call 
is  open_  147 (device,  flags,  nib,  h,  np).  Table  2.20-138  describes  the  parameters  used  by 
using  this  function. 


Parameter 


device 


flaos 


mb 


Parameters 


inter  to  char 


int 


pointer  to  struct 
net  info  block 


int 


inter  to  struct  netlib  pb 


Where  Tvpedef  Declared 


Standard  C  type. 


Standard  C  type. 


/simnet/libsrc/libnetif/netw/ork. 

h 


Standard  C  type. 


/simnet/libsrc/libnetif/libnet.h 


Return  Values 


Return  Value 


-1 


Type 


int 


Meaning 


Always  returned. 


Called  B 


Function 

Where  Described 

net  open 

Section  2.20.2.10.1. 

2.20.2.10.6 


Table  2.20*138  open_147  Information. 
get_type 


get_type  is  an  internal  library  function  that  gets  the  type  of  the  network  interface,  whether 
cmc  (NIF_TYPE_CMC)  or  MVME147  (NIF_TYPE_147).  np  is  a  pointer  to  the  control 
structure  for  the  access;  dev  is  a  pointer  to  the  device  name;  flags  are  the  flags  passed  to 
net_open.  net_access()  is  only  called  if  SIMBFLY  is  defined  The  function  call  is 
get_type(np,dev,flags)  Table  2.20-139  describes  ihe  parameters  used  and  functions  callcti 
using  this  function. 
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Parameter 


np 


Parameters 


register  pointer  to  struct 
netlib  pb 


inter  to  char 


Where  TvDedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Variable 


Internal  Variables 


e 


Where  Tvpedef  Declared 


Standard  C  type. 


Return  Values 


Return  Value 


-1 


Meanin 


Unsuccessful. 


Successful. 


Function 


net  access 


XXX  OPEN 


XXX  lOCTL 


XXX  CLOSE 


Calls 


Where  Described 


Section  2.20.2.20.1. 


Macro  defined  in  /simnet/libsrc/libnetif/hbnet.h. 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Called  B 


Function 

Where  Described 

net  open 

Section  2.20.2.10.1. 

2.20.2.10.7 


Table  2.20-139  get_type  Information. 
get_device_number 


get_device_number  always  returns  0.  The  function  call  is  get_device_number(device). 
Table  2.20-140  describes  the  parameters  used  by  this  function. 


Parameter 


device 


\n 


Parameters 


e 


inter  to  char 


Return  Values 


Where  Typedef  Declared 


Standard  C  t 


Return  Value 


Meanin 


Always  returned. 


Function 


net  open 


open  cmc 


Called  B 


Where  Described 


Section  2.20.2.10.1. 


Section  2.20.2.10.4. 


Table  2.20-140  get_device_number  Information. 
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2.20.2.11  net_nica.c 

/siinnet/libsrc/libneti^net_inca.c 

net_mca.c  cmtains  routines  to  control  multicast  addressing. 

2.20.2.11.1  net_add_mca 

net_add_mca  adds  a  multicast  address  to  the  list  of  multicast  addresses  that  the  network 
interface  is  filtering  on.  The  pna  argument  is  a  pointer  to  the  multicast  address.  Up  to  the 
number  of  addresses  specified  in  the  networic.def  file  (see  network.def)  may  be  passes  to 
the  network  interface.  The  function  call  is  net_add_mca(h,  pna).  Table  2.20-141  describes 
the  parameters  used,  return  values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

pna 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-141  net_add_inca  Information. 

2.20.2.11.2  net_del_mca 

net_del_mca  deletes  a  multicast  address  from  the  list  of  multicast  addresses  on  which  the 
network  interface  is  filtering.  The  pna  argument  is  a  pointer  to  the  multicast  address.  Up 
to  the  number  of  addresses  specified  in  the  network.def  file  (see  network.def)  may  be 
passes  to  the  network  interface.  The  function  call  is  net_deLmca(h,  pna).  Table  2.20-142 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

pna 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network 

h 

1  1 
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Return  Values 


Return  Value 


-1 


Meanin 


Operation  failed,  ermo  set  to 
indicate  error. 


Successful. 


Error  Name 


EBADF 


10 


Errors 


Reason  for  Error 


Not  a  valid  descnptor. 


The  network  interface  did  not  respond. 


Function 


CHECK  HANDLE 


net  access 


2.20.2.11.3 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Section  2.20.2.20.1. 


Table  2.20*142  net_del_mca  Information, 
net  init  mca 


net_init_mca  initializes  the  list  of  multicast  addresses  (deletes  all  addresses).  Up  to  the 
number  of  addresses  specified  in  the  network.def  file  (see  network.de0  may  be  passed  to 
the  network  interface.  The  function  call  is  net_init_mca(h).  Table  2.20- 143  describes  the 
parameters  used,  return  values  and  possible  errors  generated  by  using  this  function. 


Parameters 


Parameter 


Where  Typedef  Declared 


Return  Values 


Return  Value 


-1 


Meaning 


Operation  failed,  errno  set  to 
indicate  error. 


Successful. 


Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor 

ElO 

The  network  interface  did  not  respond 

Function 


CHECK  HANDLE 


net  access 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Section  2.20.2.20.1. 


Table  2.20-143  net  Init  mca  Information. 


2.20.2.12  net_stam.c 

/simnet/libsrc/libnetif/net_stam.c 
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2.20.2.12.1  net_stamp_enable 

net_stamp_enable  enables  packet  timestamping  for  the  network  interface  specified  by 
descriptor  h.  The  default  condition  upon  power  up  is  timestamping  disabled.  The  function 
call  is  net_stamp_enable(h).  Table  2.20-144  describes  the  parameters  used,  return  values 
and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

I  Errors  I 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

I  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20>144  net_stamp_enable  Information. 

2.20.2.12.2  net_stamp_disable 

net_stamp_disable  disables  packet  timestamping  for  the  network  interface  specified  by 
descriptor  h.  The  default  condition  upon  power  up  is  timestamping  disabled.  The  function 
call  is  net_stamp_disable(h).  Table  2.20-145  describes  the  parameters  used,  return  values 
and  possible  errors  generated  by  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

I  n 
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1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnetyiibsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-145  net_stainp_disable  Information. 

2.20.2.12.3  net_get_timestamp 

net_get_tiinestamp  gets  the  timestamp  for  the  last  packet  received  from  the  networic 
interface  specified  by  descriptor  h.  TTie  value  returned  has  meaning  only  if  timestamping  is 
enabled,  ^ch  received  packet  is  timestamped  (when  enabled)  with  the  number  of  ticks 
(where  a  tick  is  998.26  microseconds)  that  have  elapsed  since  the  network  interface  was 
booted  or  the  timer  on  the  network  interface  was  set  until  the  packet  was  received.  The 
function  call  is  net_get_timestamp(h).  Table  2.20-146  describes  the  parameters  used, 
return  values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

h 

int 

Standard  C  tvpe. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

timestamp  of  most  recent 
packet 

int 

Successfui. 

1  Errors  1 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-146  net_get_timestamp  Information. 

2.20.2.12.4  net_put_timestamp 

net_put_timestamp  sets  the  timestamp  value  to  time  for  the  next  packet  to  be  transmitted  on 
the  network  interface  specified  by  descriptor  h.  The  value  is  significant  only  if 
timestamping  is  enabled.  The  next  packet  will  not  actually  be  transmitted  until  the  timer 
value  of  the  timer  on  the  network  interface  equals  or  is  greater  than  the  timestamp  value  set 
with  net_set_timestamp.  The  function  call  is  net_put_timestamp(h,  time).  Table  2.20-147 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 
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Parameter 


Parameters 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  tvoe. 


Return  Value 


-1 


Return  Values 


Type 


int 


Meanin 


Operation  failed,  errno  set  to 
indicate  error. 


Successful. 


Error  Name 


EBADF 


Errors 


Reason  for  Error 


Not  a  valid  descriotor. 


Function 


CHECK  HANDLE 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Table  2.20-147  net_put_timestamp  Information. 


2.20.2.13  net_run.c 

/simnet/libsrc/libnetif/net_mn.c 


2.20.2.13.1 


net  run 


net_run  causes  the  network  interface  to  begin  executing  downloaded  code.  Initially,  the 
processor  is  executing  out  of  a  rom-based  kernel.  The  net_run  call  causes  control  to  be 
transferred  to  the  downloaded  code  from  the  rommed  kernel  on  the  network  card.  The 
processor  then  executes  in  an  idle  loop,  waiting  for  a  command  to  cause  it  to  start  executing 
cither  in  normal  mode  (Section  2.20.2.7.1,  net_norm),  internal  loopback  mode  (Section 
2.20.2.7.2,  net_intloop),  or  external  loopback  mode  (Section  2.20.2.7.3,  net_extloop). 
Also  Section  2.20.2.13.2,  net_stop.  The  function  call  is  net_run(h).  Table  2.20-148 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 


Parameter 


Parameters 


Where  Typedef  Declared 


Standard  C  type. 


Return  Value 


-1 


Return  Values 


Type 


int 


Meaning 


Operation  failed,  errno  set  to 
indicate  error. 


Successful. 


Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 
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1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-148  net_run  Information. 

2.20.2.13.2  net_stop 

net_stop  causes  control  to  return  to  the  idle  loop.  It  is  used  in  conjunction  with  net_run. 
The  function  call  is  net_stop(h).  Table  2.20-149  describes  the  parameters  used,  return 
values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

h 

Lint ! 

Standard  C  tvpe. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  tc 
indicate  error. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

ElO 

The  network  interface  did  not  respond. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-149  net_stop  Information. 

2.20.2.14  net_orecv.c 

/simnet/libsrc/libnetif/net_orecv.c 

net_orecv.c  contains  routines  to  perform  data  access  functions. 

2.20.2.14.1  net_recv 

net_recv  reads  the  next  available  packet  from  the  network  interface  into  buffer  birf  if  hdr  is 
NULL  or  copies  the  Ethernet  header  into  hdr  if  hdr  is  non-NULL  and  places  the  data 
portion  of  the  packet  into  buffer  buf.  In  either  case,  the  number  of  bytes  placed  in  plen  is 
obtained  from  the  bufsize.  Three  flag  bits  may  be  specified  in  flags  which  affect  how  the 
write  access  will  be  performed.  If  NETLOCK  is  set,  a  semaphore  is  used  to  enforce 
exclusive  access  to  the  queue  of  packets.  This  allows  multiple  processes  to  read  the  packet 
queues  without  corrupting  the  data  structures  that  control  access  by  the  network  interface 
and  host  processes  to  the  packet  queues.  If  NETLCXDK  is  not  set,  the  semaphores  are  not 
examined  or  set  and  only  one  process  is  assumed  to  ever  access  the  queues.  If  NETWAIT 
is  set,  the  net_recv  call  will  poll  (spin)  until  a  packet  can  be  obtained  from  the  queue.  If 
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NETWAIT  is  not  set,  net_recv  will  return  a  TRUE  indication  if  a  packet  was  successfully 
received  and  a  FALSE  indication  if  not.  Note  that  if  both  NETWAIT  and  NETLOCK  are 
set,  the  process  will  sleep  on  the  semaphore  associated  with  the  queue  and  the  poll  the 
queue  until  a  packet  is  received.  If  NETBLOCK  is  set,  the  net_recv  call  will  perform  a 
blocking  access  of  the  appropriate  packet  queue.  This  is  true  blocking  access,  i.e.,  the 
calling  process  will  sleep.  TTie  access  will  be  exclusive,  i.e.,  a  semaphore  will  be  used  to 
control  access.  NETWAIT  and  NETLOCK  may  not  be  specified  in  conjunction  with 
NETBLOCK.  A  timeout  for  blocking  accesses  may  be  specified  via  the  net_settimeout 
call.  The  function  call  is  net_recv(h,  hdr,  buf,  bufsize,  plen,  flags).  Table  2.20-150 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 


Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

hdr 

pointer  tc  NetworkHeader 

/simnet/libsrc/libnetif/network. 

h 

buf 

pointer  to  char 

Standard  C  type. 

bufsize 

int 

Standard  C  type. 

plen 

pointer  to  int 

Standard  C  type. 

flags 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

ret 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  tailed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

E2BIG 

Bad  register  number. 

EBADF 

Not  a  valid  descriptor. 

EINVAL 

Memory  cannot  be  mapped. 

ElO 

Timeout  occured. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

recv  cmc 

Section  2.20.2.14.2. 

recv  147 

Section  2.20.2.14.3. 

Table  2.20-150  net  recv  Information. 
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2.20.2.14.2 


recv  cmc 


recv_cmc  is  the  receive  handler  for  the  cmc  card.  It  is  an  internal  library  function. 
Arguments  are  the  same  as  net_rcv,  except  for  the  addition  of  np  which  is  a  pointer  to  the 
access  control  structure,  blocking  args  and  the  call  to  net_access()  are  only  used  if 
SIMBFLY  is  NOT  defined.  The  function  call  is  recv_cmc(h,  hdr,  buf,  bufsize,  plen, 
flags,  np).  Table  2.20-151  describes  the  parameters  used,  errors  returned  and  Unctions 
called  using  this  function. 


Parameter 


buf 


bufsize 


len 


flags 


np 


Parameters 


pointer  to  NetworkHeader 


inter  to  char 


register  pointer  to  struct 
netlib  ob 


Where  Tyoedef  Declared 


Standard  C  t 


/simnet/libsrc/libnetif/network. 

h 


Standard  C  t 


Standard  C  type. 


Standard  C  t 


Standard  C  t 


/simnet/libsrc/libnetif/libnet.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

rp 

pointer  to  VOLATILE 
RingElement 

/simnet/libsrc/libnetif/network. 

h 

ret 


blocking  args 


struct  enprwsuppoil  an 


Standard  C  type. 


Standard  C  type. 


Return  Value 


-1 


Return  Values 


Meanin 


Unsuccessful.  Error  code 
returned  in  erno. 


0  if  successful.  -1  if 
unsuccessful. 


Error  Name 


EWOULDBLOCK 


EINVAL 


E2BIG 


Errors 


Reason  for  Error 


Calls 

Function 

Where  Described 

GETLONG 

Macro  defined  in  /simnewt/libsrc/libnetif/libnet.h. 

wait  for  full  ring  element 

Section  2.20.2.17.8. 

POLL  LOCK 

Macro  defined  in  /simnewt/libsrc/libnetif/netlock.h. 

REMOVE  LOCK 

Macro  defined  in  /simnewt/libsrc/libnetif/netlock.h. 

WAIT  FOR  LOCK 

Macro  defined  in  /simnewt/libsrc/libnetif/netlock.h. 

net  access 

Section  2.20.2.20.1. 

L  REFLECT 

compat.h 

DATACOPY 

Macro  defined  in  /simnewVlibsrc/libnetif/libnet.h. 

SETLONG 

Macro  defined  in  /simnewt/libsrc/libnetif/libnet.h. 
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1  Called  By  1 

Function 

Where  Described 

net  recv 

Section  2.20.2.14.1. 

Table  2.20-151  recv_cinc  Information. 

2.20.2.14.3  recv_147 

recv_147  is  not  supported  by  any  computer  currently  used  in  SIMNET.  The  function  call 
is  recv_147(h,  hdr,  buf,  bufsize,  plen,  flags,  np).  Table  2.20-152  describes  the 
parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

hdr 

pointer  to  NetworkHeader 

/simnet/libsrc/libnetif/network. 

h 

buf 

pointer  to  char 

Standard  C  type. 

bufsize 

int 

Standard  C  type. 

plen 

pointer  to  int 

Standard  C  type. 

flaps 

int 

Standard  C  type. 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Always  returned. 

1  Called  By  I 

Function 

Where  Described 

net  recv 

Section  2.20.2.14.1. 

Table  2.20-152  recv_147  Information. 

2.20.2.14.4  net_get_next_packet 

net_get_next_packet  is  not  used  in  the  version  6.6  release.  The  function  call  is 
net_get_next_packet(h,  hdr,  buf,  plen,  flags).  Table  2.20-153  describes  the  parameters 
u.sed  and  functions  called  using  this  function. 


j  Parameters  | 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

hdr 

pointer  to  pointer  to 

/simnet/libsrc/libnetif/network. 

NetworkHeader 

h 

buf 

pointer  to  pointer  to  char 

Standard  C  type. 

plen 

pointer  to  int 

Standard  C  type. 

flags 

int 

Standard  C  type. 
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I  Return  Values  1 

Return  Value 

Type 

Meaning 

net jget_recv(h,  hdr,  b  uf. 
plen,  flaas) 

int 

Not  applicable 

Calls 

Function 

Where  Described 

net  qet  recv 

Section  2.20.2.14.6. 

Table  2.20-153  net_get_next_packet  Information. 
2.20.2.14.5  net_release_next_packet 

net_release_next  j)acket  is  not  used  in  the  version  6.6  release.  The  function  call  is 
net_release_next_packet(h,  flags).  Table  2.20-154  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Deciared 

h 

int 

Standard  C  type. 

flaas 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

net release recv(h,  flags) 

int 

Not  applicable 

1  Calls  i 

Function 

Where  Described 

net  release  recv 

Section  2.20.2.14.7. 

Table  2.20-154  net_release_next_packet  Information. 
2.20.2.14.6  net_get_recv 

net_get_recv  gets  a  pointer  to  the  header,  /idr,  and  the  data  part,  buf,  of  the  next  packet  in 
the  queue  and  also  returns  the  number  of  bytes  in  the  buffer,  plen.  It  will  not  try  to  use 
NULL  pointers  passed  as  arguments.  The  function  call  is  net_get_recv(h,  hdr,  buf,  plen, 
flags).  Table  2.20-155  describes  the  parameters  used,  errors  returned  and  functions  called 
using  this  function. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

hdr 

pointer  to  pointer  to 

/simnet/libsrc/libnetif/network. 

NetworkHeader 

h 

buf 

pointer  to  pointer  to  char 

Standard  C  type. 

plen 

pointer  to  int 

Standard  C  type. 

flags 

int 

Standard  C  type. 

1  1 
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Variable 


np 


Internal  Variables 


register  pointer  to  stoict 
netlib  ob 


register  pointer  to 
RinoElement 


int 


MCC  CSCI 


Where  Typedef  Declared 


/si  mnet/libsrc/libnetif/libnet .  h 


/simnet/ybsrc/ybnetif/network. 

h 


Standard  C  t 


Return  Values 


Return  Value 


ret 


Meanin 


0  if  successful  and  packet 
waitinq.  -1  if  not  successful. 


Error  Name 


EWOULDBLOCK 


Errors 


Reason  for  Error 


Function 


CHECK  HANDLE 


GETLONG 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Called  B 


Function 

Where  Described 

net  aet  next  packet 

Section  2.20.2.14.4. 

2.20.2.14.7 


Table  2.20-155  net_get_recv  Information, 
net  release  recv 


net_release_recv  releases  the  next  queue  element  and  returns.  The  function  call  is 
net_release_recv(h,  flags).  Table  2.20-156  describes  the  parameters  used  and  functions 
called  using  this  f^unction. 


Parameters 


Parameter 


flaas 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

np 

register  pointer  to 

RinoElement 

/simnet/libsrc/libnetif/network. 

h 

Standard  C  t 


Standard  C  type. 


Return  Values 

Return  Value 

Type 

Meaning 

ret 

int 

0  if  successful  1  if  not 
successful. 
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1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

GETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

SETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Called  By 

Function 

Where  Described 

net  release  next  packet 

Section  2.20.2.14.5. 

Table  2.20-156  net_release_recv  Information. 

2.20.2.15  net_osend.c 

/simnei/libsrc/libnetif/net_osend.c 

2.20.2.15.1  net_send 

net_send  writes  the  packet  in  buffer  buf  io  the  network  interface  if  hdr  is  NULL  or  obtains 
the  Ethernet  header  from  hdr  if  hdr  is  non-NULL  and  the  data  portion  of  the  packet  from 
buffer  buf.  In  either  case,  the  number  of  bytes  read  from  bitf  is  obtained  from  the  len 
argument.  Three  flag  bits  may  be  specified  in  flags  which  affect  how  the  write  access  will 
be  performed.  If  NETLOCK  is  set,  a  semaphore  is  used  to  enforce  exclusive  access  to  the 
queue  of  packets.  This  allows  multiple  processes  to  write  the  packet  queues  without 
corrupting  the  data  structures  that  control  access  by  the  network  interface  and  host 
processes  to  the  packet  queues.  If  NETLOCK  is  not  set,  the  semaphores  are  not  examined 
or  set  and  only  one  process  is  assumed  to  ever  access  the  queues.  If  NETWAIT  is  set,  the 
net_send  call  will  poll  (spin)  until  a  packet  can  be  obtained  from  the  queue.  If  NETWAIT 
is  not  set,  net_send  will  return  a  TRUE  indication  if  a  packet  was  successfully  transmitted 
and  a  FALSE  indication  if  not.  Note  that  if  both  NETWAIT  and  NETLOCK  are  set,  the 
process  will  sleep  on  the  semaphore  associated  with  the  queue  and  poll  the  queue  until  a 
packet  is  received.  If  NETBLOCK  is  set,  the  net_send  call  will  perform  a  blocking  access 
of  the  appropriate  packet  queue.  This  is  true  blocking  access,  i.e.,  the  calling  process  will 
sleep.  The  access  will  be  exclusive,  i.e.,  a  semaphore  will  be  used  to  control  access. 
NETWAIT  and  NETLOCK  may  not  be  specified  in  conjunction  with  NETBLOCK.  A 
timeout  for  blocking  accesses  may  be  specified  via  the  net_settimeout  call.  The  function 
call  is  net_send(h,  hdr,  buf,  len,  flags).  Table  2.20-157  describes  the  parameters  used, 
return  values  and  possible  errors  generated  by  using  this  function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

hdr 

pointer  to  NetworkHeader 

/simnet/libsrc/libnetif/network. 

h 

buf 

pointer  to  char 

Standard  C  type. 

len 

int 

Standard  C  type. 

flaqs 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

ret 

int 

Standard  C  type. 

I  I 
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Return  Value 


-1 


Return  Values 


Meanin 


Operation  failed,  ermo  set  to 
indicate  error. 


Successful. 


Error  Name 


E2BIG 


EBADF 


EINVAL 


ElO 


Errors 


Reason  for  Error 


Bad  reoister  number. 


Not  a  valid  descnotor. 


Memory  cannot  be  ma 


Timeout  occured. 


Function 


CHECK  HANDLE 


send  cmc 


send  147 


2.20.2.15.2 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/tibnetif/libnet.h. 


Section  2.20.2.15.2. 


Section  2.20.2.15.3. 


Table  2.20-157  net_send  Information, 
send  cmc 


send_cmc  is  the  send  handler  for  the  cmc  card.  It  takes  the  same  arguments  as  net_send 
(Section  2.20.2.15.1)  except  for  the  addition  of  np  which  is  a  pointer  to  the  access  control 
structure,  bloddngjtrgs  and  the  call  to  net_access()  are  only  used  if  SIMBFLY  is  NOT 
defined.  The  function  call  is  send_cmc(h,hdr,buf,len, flags, np).  Table  2.20-158  describes 
the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


Parameter 


Parameters 


pointer  to  NetworkHeader 


register  pointer  to  struct 
netlib  ob 


Where  Tvoedef  Declared 


Standard  C  tyoe. 


/simnet/libsrc/libnetif/network. 

h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


/simnet/libsrc/libnetif.'libnet.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

rp 

pointer  to  VOLATILE 
RinoElement 

/simnet/libsrc/libnetif/network. 

h 

blockinq  arqs 

struct  enprwsu 

Standard  C  t 


enparq.h 


Return  Value 


Return  Values 


Type 

Meaning 

int 

Successful. 

int 

Unsuccessful. 
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Error  Name 


EWOULDBLOCK 


EINVAL 


Errors 


Reason  for  Error 


Memory  cannot  be  ma 


Calls 

Function 

Where  Described 

GETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

wait  for  empty  ring  element 

Section  2.20.2.19.1. 

POLL  LOCK 

Macro  defined  in  /simnet/libsrc/libnetif/netlock.h. 

REMOVE  LOCK 

Macro  defined  in  /simnet/libsrc/libnetif/netlock.h. 

WAIT  FOR  LOCK 

Macro  defined  in  /simnet/libsrc/libnetif/netlock.h. 

net  access 

Section  2.20.2.20.1. 

DATACOPY 


SETLON  G 


L  REFLECT 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h 


comoat.h 


Called  B 


Function 

Where  Described 

net  send 

Section  2.20.2.15.1. 

2.20.2.15.3 


Table  2.20-158  send^cmc  Information, 
send  147 


send_147  is  not  currently  supported  by  any  computer  used  in  SIMNET.  The  function  call 
is  send_I47(h,  hsr,  buf,  len,  flags,  np).  Table  2,20-159  describes  the  parameters  used  by 
this  function. 


Parameters  j 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

hdr 

pointer  to  NetworkHeader 

/si  mnet/libsrc/li  bnetif/network . 
h 

buf 

pointer  to  char 

Standard  C  type. 

len 

int 

Standard  C  type. 

flags 

int 

Standard  C  type. 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

Return  Value 

-1 


Return  Values 
Type _ 

int 


Meaning 
Always  returned. 


Called  B 


Function 

Where  Described 

net  send 

Section  2.20.2.15.1. 

Table  2.20-159  send  147  Information. 
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2.20.2.15.4  net_get_send 

net_get_send  is  not  used  in  the  version  6.6  release.  The  function  call  is  net_get_send(h, 
hdr,  buf,  plen,  flags).  Table  2.20-160  describes  the  parameters  used,  errors  returned  and 
functions  called  using  this  function. 


Parameters 


Parameter 


lEin 


int 


pointer  to  pointer  to 
NetworkHeader 


inter  to  pointer  to  char 


inter  to  int 


int 


Where  Tvoedef  Declared 


Standard  C  t 


/simnet/libsrc/libnetif/network. 

h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Variable 


np 


Internal  Variables 


e 


register  pointer  to  struct 
netlib  Ob 


register  pointer  to 
RinoElement 


int 


Where  Tvoedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


/simnet/libsrc/libnetif/network. 

h 


Standard  C  type. 


Return  Value 


ret 


Return  Values 


Meanin 


0  if  successful  and  buffer 
available  waiting.  -1  if  not 
successful. 


Error  Name 


EWOULDBLOCK 


Function 


CHECK  HANDLE 


GETLONG 


Errors 


Reason  for  Error 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Table  2.20-160  net_get_send  Information. 
2.20.2.15.5  net  release  send 


net_release_send  releases  the  next  queue  element  and  returns.  The  function  call  is 
net_release_send(h,  flags).  Table  2.20-161  describes  the  parameters  used  nnd  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

flags 

int 

Standard  C  type. 

1  1 
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Variable 


np 


Internal  Variables 


register  pointer  to  struct 
netlib  ob 


pointer  to  RingElement 


Where  TvDedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


/simnet/libsrc/libnetif/network. 

h 


Standard  C  t 


Standard  C  t 


Return  Values 


Return  Value 


ret 


Meanin 


0  it  successful.  -1  it  not 
successful. 


Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

GETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

SETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-161  net  release  send  Information. 


2.20.2.16  net_reg.c 

/simnet/libsrc/libnetif/net_reg.c 

net_reg.c  contains  routines  to  access  the  network  interface  registers. 

2.20.2.16.1  net_reg_read 

net_reg_read  reads  the  value  of  the  network  interface  register  specified  by  regnum  and 
returns  the  value  into  pval.  The  network  interface  registers  are  a  block  of 
NUMBER_OF_REGISTERS  long  words  directly  mapped  into  a  process’s  segment  for 
rapid  access.  The  registers  are  av^able  for  communication  with  on-board  packet  filtering 
routines  (see  net_filter).  The  ENP30  implementation  (Multibus)  reads  and  writes  a  short 
(16  bits)  at  a  time,  so  accesses  are  not  necessarily  atomic.  The  function  call  is 
net_reg_read(h,  regnum,  pval).  Table  2.20-162  describes  the  parameters  used,  return 
values  and  possible  errors  generated  by  using  this  function. 
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1  Errors  1 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

EINVAL 

Memory  cannot  be  mapped. 

E2BIG 

Bad  reqister  number. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

GETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-162  net_reg_read  Information. 

2.20.2.16.2  net_reg_write 

net_reg_write  writes  the  value  val  into  the  netwwk  interface  register  specified  by  regnum. 
The  netwoilc  interface  registers  are  a  block  of  NUMBER_OF_REGISTERS  long  words 
directly  mapped  into  a  process’s  segment  for  rapid  access.  The  registers  are  available  for 
communication  with  on-board  packet  filtering  routines  (see  net_filter).  The  ENP30 
implementation  (Multibus)  reads  and  writes  a  short  (16  bits)  at  a  time,  so  accesses  are  not 
necessarily  automatic.  The  function  call  is  net_reg_write(h,  regnum,  val).  Table  2.20-163 
describes  the  parameters  used,  return  values  and  possible  errors  generated  by  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Typedef  Deciared 

h 

int 

Standard  C  type. 

regnum 

int 

Standard  C  type. 

val 

long 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

1  Errors  1 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

EINVAL 

Memory  cannot  be  mapped. 

E2BIG 

Bad  register  number. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

SETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-163  net  reg  write  Information. 
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2.20.2.17  net_recv.c 

/siiTinet/libsrc/libneti^net_recv.c 

2.20.2.17.1  net_reset_lock 

net_reset_lock  initializes  the  semaphore  governing  the  ring  buffers  on  the  MASSCDMP. 
This  is  necessary  only  for  ringstart  and  in  case  any  routine  dies  while  it  has  the  rings 
locked.  The  function  call  is  net_reset_lock(h).  Table  2.20-164  describes  the  parameters 
used,  return  values  and  possible  errors  generated  by  using  this  function. 


1  Parameters  I 

■  Parameter 

Type 

Where  Tvpedef  Declared 

Lh _ _ _ 

tnt 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

su 

union  su 

/simnet/libsrc/libnetif/net_recv 

•C 

np 

register  pointer  to  stmct 
netlib  pb 

/simnet/libsrc/libnetif/libnet .  h 

1  Return  Values  1 

Return  Value 

Meaning 

•1 

int 

Operation  failed,  errno  set  to 
indicate  error. 

0 

int 

Successful. 

I  Errors  I 

Error  Name 

Reason  for  Error 

EBADF 

Not  a  valid  descriptor. 

I  Calls  I 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-164  net_reseMock  Information. 

2.20.2.17.2  net_rcv 

net_rcv  receives  a  packet.  The  data  portion  of  the  packet  is  returned  to  birf.  birfsize  is  the 
size  of  buf  in  bytes.  The  number  of  bytes  actually  copied  into  bufis  returned  in  len.  The 
destination  and  source  addresses  and  the  packet  type  may  be  obtained  from  calls  to  Section 

2.20.2.17.3  net_get_rcv_to_addr.  Section  2.20.2.17.4  net_get_rcv_from_addr  and 
Section  2.20.2.17.5  net_get_rcvtype.  The  function  call  is  net_rcv(h,  buf,  bufsize,  len, 
flags).  Table  2.20-165  describes  the  parameters  used  and  functions  called  using  this 
function. 
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Parameters 


Parameter 


but 


bufsize 


isn 


s 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Variable 


np 


Internal  Variables 


register  pointer  to  struct 
nettib  pb 


int 


Where  Tvoedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Standard  C  t 


Return  Value 


ret 


Return  Values 


Meaning _ 


0  if  successful.  -1  if  not 
successful. 


Function 


CHECK  HANDLE 


recv  cmc  8023 


recv  147  8023 


2.20.2.17.3 


Calls 


Where  Described 


Macro  defined  in  /simnetyiibsrc/libnetif/libnet.h. 


Section  2.20.2.17.6. 


Section  2.20.2.17.7. 


Table  2.20>165  net_rcv  Information. 
net_get_rcv_to_addr 


net_get_rcv_to_addr  gets  the  destination  address  of  the  last  packet  received  via  the  calls  to 
Section  2.20.2.17.2  net_rcv  or  Section  2.20.2.17.9  net_get_rcv.  The  function  call  is 
net_get_rcv_to_addr(h,  to).  Table  2.20-166  describes  the  parameters  used,  errors  returned 
and  functions  called  using  this  function. 


Parameters 


Parameter 


Type 

Where  Typedef  Declared 

int 

Standard  C  type. 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

Return  Values 

Type 

Meaning 

int 

Successful. 

int 

Unsuccessful.  Error  code 
returned  in  errno 

Return  Value 


Error  Name 


EBADF 


Errors 


Reason  for  Error 


Bad  handle 
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1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-166  net_get_rcv_to_addr  Information. 
2.20.2.17.4  net_get_rc  v_from_addr 

net_get_rcv_firom_addr  gets  the  source  address  of  the  last  packet  received  via  the  calls  to 
Section  2.20.2.17.2  net_rcv  or  Section  2.20.2.17.9  net_get_rcv.  The  function  call  is 
net_get_rcv_firom_addr(h,  from).  Table  2.20-167  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

inf 

Standard  C  type. 

from 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

Return  Values 

Return  Value 

Type 

Meaning 

0 

inf 

Successful. 

-1 

int 

Unsuccessful.  Error  code 
returned  in  errno. 

Errors 

Error  Name 

Reason  for  Error 

EBADF 

Bad  handle. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnel/libsrc/libnetif/iibnet.h. 

Table  2.20-167  net_get_rcv_from_addr  Information. 
2.20.2.17.5  net_get_rcv_type 

net_get_rcv_type  gets  the  type  of  the  last  packet  received  via  the  calls  to  Section 
2.20.2.17.2  net_rcv  or  Section  2.20.2.17.9  net_get_rcv.  The  function  call  is 
net_get_rcv_type(h).  Table  2.20-168  describes  the  parameters  used,  errors  returned  and 
functions  call^  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

npbfhJ.rcvType 

int 

Type  of  last  packet  received. 

1  1 
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1  Errors  I 

Error  Name 

Reason  for  Error 

EBADF 

Bad  handle. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20*168  net_get_rcv_type  Information. 


2.20.2.17.6  recv_cmc_8023 

rccv_cmc_8023  is  the  receive  handler  for  the  cmc  card  for  802.3  packets.  The  parameters 
are  the  same  as  for  net_rcv  except  for  the  addition  of  np  which  is  a  pointer  to  the  access 
control  structure  for  the  access,  blocking  args  and  the  call  to  net_access  will  only  be  used 
if  SIMBFLY  is  NOT  defined.  The  function  call  is  recv_cmc_8023(h,  buf,  bufsize,  plen, 
flags,  np)  Table  2.20-169  describes  the  parameters  used,  errors  returned  and  functions 
called  using  this  function. 


Parameters 


Parameter 


buf 


bufsize 


len 


flaas 


np 


register  pointer  to  struct 
netlib  pb 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  tvpe. 


Standard  C  tvpe. 


Standard  C  tvoe. 


Standard  C  tvoe. 


/simnet/libsrc/tibnetil/iibnet.h 


Variabie 


data 


ret 


blockino  arcs 


Internal  Variables 


e 


pointer  to  VOLATI  LE  char 


mt 


register  pointer  to 
QueueElement 


int 


int 


rt  ar 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


/simnet/libsi'c/libnetif/network. 

h 


Standard  C  type. 


Standard  C  type. 


Return  Value 


-1 


Return  Values 


Type 


int 


Meaning  _ 


Unsuccessful  Error  code 
returned  in  errno. 


Successful,  ret  will  be  0. 


Error  Name 


EWOULDBLOCK 


EINVAL 


E2BIG 


Errors 


Reason  for  Error 


Input  queue  empty  no  packet  available 


Unknown  fla 


Packet  too  biq  for  supplied  buffer 
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1  Calls  1 

Function 

Where  Described 

GETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

wait  for  full  rino  element 

Section  2.20.2.17.8. 

POLL  LOCK 

Macro  defined  in  /simnet/libsrc/libnetif/netlock.h. 

REMOVE  LOCK 

Macro  defined  in  /simnet/libsrc/libnetif/netlock.h. 

WAIT  FOR  LOCK 

Macro  defined  in  /simnet/libsrc/libnetif/netlock.h. 

net  acx:ess 

Section  2.20.2.20.1. 

L  REFLECT 

comoat.h 

movewords 

Function  defined  in  libnwve.  Section  2.21.5. 

GET  ETHER  TYPE 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

GET  DATA  PTR 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

DATACOPY 

Macro  defined  in  /simnet/iibsrc/libnetif/libnet.h. 

SETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Called  By 

Function 

Where  Described 

net  rev 

Section  2.20.2.17.2. 

Table  2.20-169  recv  cmc  8023  Information. 


2.20.2.17.7  recv  147  8023 


recv_147_8023  is  not  supported  for  any  computer  currently  used  by  SIMNET.  The 
function  call  is  recv_147_8023(h,  buf,  bufsize,  plen,  size,  np).  Table  2.20-170  describes 
the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

buf 

pointer  to  char 

Standard  C  type. 

bufsize 

int 

Standard  C  type. 

plen 

pointer  to  int 

Standard  C  type. 

flags 

int 

Standard  C  type. 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetit/libnet.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Always  returned. 

I  Called  By  I 

Function 

Where  Described 

net  rev 

Section  2.20.2.17.2. 

Table  2.20-170  recv  147  8023  Information. 
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2.20.2.17.8  wait_for_full_ring_element 


wait_for_full_ring_element  is  a  waiting  function  necessary  for  the  MIPS  computer.  The 
function  call  is  wait_for_full_ring_element(rp).  Table  2.20-171  describes  the  parameters 
used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

rp 

pointer  to  VOLATILE 
RinaElement 

/simnet/libsrc/libnetif/network. 

h 

1  Internal  Variables  1 

[Variable 

Type 

Where  Typedef  Declared 

int 

Standard  C  type. 

li 

reqister  int 

K  r:1 1> 

1  Called  By  1 

Function 

Where  Described 

recv  cmc 

Section  2.20.2.14.2. 

recv  cmc  8023 

Section  2.20.2.17.6. 

Table  2.20-171  wait_for_full_ring_element  Information. 
2.20.2.17.9  net_get_rcv 

net_get_rcv  gets  a  pointer,  birf,  to  the  data  part  of  the  next  packet  in  the  queue  and  also 
returns  the  number  of  bytes  in  the  buffer,  plen.  The  function  call  is  net_get_rcv(h,  buf, 
plen,  flags).  Table  2.20-172  Jescribes  the  parameters  used,  errors  returned  and  functions 
called  using  this  function. 


1  Parameters  j 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

buf 

pointer  to  pointer  to  char 

Standard  C  type. 

plen 

pointer  to  int 

Standard  C  type. 

flags 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif'libnet.h 

rp 

register  pointer  to 
QueueElement 

/simnet/libsrc/libnetif/network. 

h 

ret 

int 

Standard  C  type 

size 

int 

Standard  C  type. 

datap 

pointer  to  char 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

ret 

int 

0  if  successful  -1 1(  not 
successful 

1  1 
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1  Errors  1 

Error  Name 

Reason  for  Error 

EWOULDBLOCK 

Input  queue  empty,  no  packet  available. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

GETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

L  REFLECT 

compat.h 

movewords 

Function  defined  in  libmove.  Section  2.21.5. 

GET  ETHER  TYPE 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

GET  DATA  PTR 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

DATACOPY 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-172  net_get_rcv  Information. 


2.20.2.17.10  net  release  rev 


net_release_rcv  releases  the  next  queue  element  and  returns.  The  function  call  is 
net_release_rcv(h,  flags).  Table  2.20-173  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

flaqs 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
net  lib  pb 

/si  mnet/libsre/libnetif/libnet .  h 

rp 

register  pointer  to 
QueueElement 

/simnet/libsre/libnetif/network. 

h 

tmp 

int 

Standard  C  type. 

ret 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

ret 

int 

0  if  successful.  -1  if  not 
successful. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/iibnet.h. 

GETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

SETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

Table  2.20-173  net_release_rcv  Information. 
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2.20.2.18  net_type.c 

/simnet/libsrc/libnetif/net_type.c 

net_type.c  contains  routines  for  ethemet  type  code  checking. 

2.20.2.18.1  net_add_type 

net_add_type  adds  a  type  code  to  the  list  of  types  that  the  network  interface  is  checking  for. 
The  function  call  is  net_add_type(h,  type).  Table  2.20-174  describes  the  parameters  used 
and  functions  called  using  this  function  while  using  a  Butterfly.  Table  2.20-175  describes 
the  parameters  used  and  functions  called  using  this  function  with  any  other  computer. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

ret 

int 

Standard  C  type. 

but 

pointer  to  char 

Standard  C  type. 

bufoid 

OID 

I  Return  Values  1 

Return  Value 

Meaning 

ret 

int 

0  if  successful.  -1  if  not 
successful. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-174  Butterfly  net_add_type  Information. 


Parameters 


Parameter 


e 


073 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

ret 

int 

Standard  C  type. 

struct  enpaccess  ar 


enparo.h 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

ret 

int 

0  if  successful.  -1  if  not 
successful. 

Calls 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-175  Other  net_add_type  Information. 

2.20.2.18.2  net_init_type 

net_init_type  initializes  a  list  of  type  codes  the  network  interface  is  checking  for.  If 
SIMBFLY  is  defined  the  last  internal  variable,  arg,  is  not  used.  The  function  call  is 
net_init_type(h).  Table  2.20-176  describes  the  parameters  used  and  functions  called  using 
this  function. 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
neflib  pb 

/simnet/libsrc/libnetif/libnet.h 

ret 

int 

Standard  C  type. 

ana 

struct  enpaccess  arq 

enparq.h 

Return  Values  1 

Return  Value 

Type 

Meaning 

ret 

int 

0  if  successful.  -1  if  not 
successful. 

Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

net  access 

Section  2.20.2.20.1. 

Table  2.20-176  net_init_type  Information. 

2.20.2.19  net_send.c 

/simnet/libsrc/libnetif/net_send.c 

2.20.2.19.1  wait_for_empty_ring_element 

wait_for_empty_ring_element  is  used  to  wait  while  doing  nothing.  It  is  necessary  for  the 
MIPS  machine.  The  function  call  is  wait_for_empty_ring_element(rp).  Table  2.20-177 
describes  the  parameters  used  by  this  function. 
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Table  2.20-177  wait_for_einpty_ring_eIement  Information. 


2.20.2.19.2 


net  snd 


net_snd  sends  a  packet.  The  function  call  is  net_snd(h,  to,  buf,  len,  flags).  Table  2.20- 
178  describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


Parameter 


h 


to 


Variable 


np 


Return  Value 


ret 


Function 


CHECK  HANDLE 


send  cmc  8023 


send  147  8023 


Parameters 


Where  Tvoedef  Declared 


Standard  C  type. 


pointer  to  NetworkAddress  /simnet/libsrc/libnetif/network. 

h 


EiTT 

iil 

E 

rs 


inter  to  char 


IE373 


Internal  Variables 


e 


register  pointer  to  struct 
netlib  pb 


int 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Where  Tvoedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Standard  C  type 


Return  Values 


Type 


int 


Meaning 


0  if  successful.  -1  if  not 
successful 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Section  2.20.2.19.3. 


Section  2.20.2.19.4. 


Table  2.20-178  net  snd  Information. 
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2.20.2.19.3 


send  cmc  8023 


send_cmc_8023  is  the  send  handler  for  the  cmc  card  for  802.3  packets.  The  parameters  are 
the  same  as  for  net_snd  except  for  the  addition  of  np  which  is  a  pointer  to  the  access  control 
structure  for  the  access,  blocking  args  and  the  call  to  net_accessO  arc  only  used  if  the 
computer  is  not  a  Butterfly.  The  function  call  is  send_cmc_8023(h,  to,  buf,  len,  flags, 
np).  Table  2.20-179  describes  the  parameters  used,  errors  returned  and  functions  called 
using  this  function. 
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1  Calls  1 

Function 

Where  Described 

GETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

wait  for  empty  ring  element 

Section  2.20.2.19.1. 

POLL  LOCK 

Macro  defined  in  /simnet/libsrc/libnetif/netlock.h. 

REMOVE  LOCK 

Macro  defined  in  /simnet/libsrc/libnetif/netlock.h. 

WAIT  FOR  LOCK 

Macro  defined  in  /simnet/libsrc/libnetif/netlock.h. 

net  access 

Section  2.20.2.20.1. 

movewords 

Function  defined  in  libmove.  Section  2.21 .5. 

SET  DSAP 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

SET  SSAP 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

SET  CONTROL 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

SET  PROTOID 

Macro  defined  in  /simnet/tibsrc/libnetif/network.h. 

SET  ETHER  TYPE 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

DATACOPY 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

GET  DATA  PTR 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

SETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

L  REFLECT 

compat.h 

Called  By 

Function 

Where  Described 

net  snd 

Section  2.20.2.19.2. 

Table  2.20-179  send  cmc  8023  Information. 


2.20.2.19.4  send  147  8023 


send_147_8023  is  not  supported  by  any  computer  used  in  SIMNET.  This  function  will 
always  return  -1.  The  function  call  is  send_147_8023(h,  to,  buf,  len,  flags,  np)  Table 
2.20-180  describes  the  parameters  used  by  this  function. 


1  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

to 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif 'network, 
h 

buf 

pointer  to  char 

Standard  C  type. 

len 

inf 

Standard  C  type. 

flags 

int 

Standard  C  type. 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/fibnet i<  libnet  h 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Always  returned 

Called  By 

Function 

Where  Described 

net  snd 

Section  2.20.2.19.2. 

Tabic  2.20-180  send_147  802.^  Inft-*  mation. 
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2.20.2.19.5 


net  set  snd  from  addr 


net_set_snd_ftom_addr  sets  the  source  address  for  subsequent  calls  to  net_snd().  If  this  is 
any  multicast  address  (least  significant  bit  of  the  first  byte  equal  to  1)  then  the  default 
address  of  the  interface  is  used.  net_set_snd_from_addr  returns  0  if  successful  and  -1  if 
not.  The  function  call  is  net_set_snd_from_addr(h,  from).  Table  2.20-181  describes  the 
parameters  used,  errors  returned  and  functions  call^  using  this  function. 


Parameters 


Parameter 


lETH 


pointer  to  NetworkAddress 


Where  Typedef  Declared 


Standard  C  t 


/simnet/libsrc/libnetif/network. 

h 


Return  Values 


Return  Value 


Type 

Meaning 

int 

Successful. 

int 

Unsuccessful. 

Error  Name 


EBADF 


Errors 


Reason  for  Error 


Bad  handle. 


Function 


CHECK  HANDLE 


Calls 


Where  Described 


Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 


Table  2.20*181  net  set  snd  from  addr  Information. 


2.20.2.19.6 


net_set_snd_type 


net_set_snd_type  sets  the  packet  type  for  subsequent  calls  to  net_snd().  It  returns  0  if 
successful  and  -1  if  not.  The  function  call  is  net_set_snd_type(h,  type).  Table  2.20-182 
describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnetyiibsrc/libnetif/libnet.h. 

Table  2.20-182  net_set_snd_type  Information. 

2.20.2.19.7  net_get_snd 

net_get_snd  gets  a  pointer,  birf,  to  the  data  part  of  the  next  packet  in  the  queue,  plen 
returns  the  size  of  birf  'm  bytes.  net_get_snd  returns  0  if  there  is  a  buffer  available  and  -1  if 
not.  The  function  cdl  is  net_get_snd(h,  buf,  plen,  flags).  Table  2.20-183  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

buf 

pointer  to  pointer  to  char 

Standard  C  type. 

plen 

pointer  to  int 

Standard  C  type. 

flaps 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

rp 

register  pointer  to 
QueueElement 

/simnet/libsrc/libnetif/network. 

h 

ret 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

ret 

int 

Successful  if  0,  unsuccessful 
if-1. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

GETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h 

GET  DATA  PTR 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

Table  2.20-183  net  get  snd  Information. 
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2.20.2.19.8 


net  release  snd 


net_release_snd  releases  the  next  queue  element  and  returns.  The  function  call  is 
net_release_snd(h,  to,  len,  flags).  Table  2,20-184  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

to 

pointer  to  NetworkAddress 

/simnet/iibsrc/libnetif/network. 

h 

len 

int 

Standard  C  type. 

flaas 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

np 

register  pointer  to  struct 
netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

tp 

register  pointer  to 

/simnet/iibsrc/libnetif/network. 

QueueElement 

h 

tmp 

int 

Standard  C  type. 

ret 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

ret 

int 

Successful  if  0,  unsuccessful 
if -1. 

1  Calls  1 

Function 

Where  Described 

CHECK  HANDLE 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

GETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

movewords 

Function  defined  in  libmove.  Section  2.21.5. 

SET  DSAP 

Macro  defined  in  /simnet/iibsrc/libnetif/network.h. 

SET  SSAP 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

SET  CONTROL 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

SET  PROTOID 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

SET  ETHER  TYPE 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

DATACOPY 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

GET  DATA  PTR 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

SETLONG 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

L  REFLECT 

compat.h 

Table  2.20-184 


net  release  snd  Information. 
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2.20.2.20  net_acce.c 
/simnet/libsrc/libnetif/net_acce.c 


2.20.2.20.1 


net  access 


net_access  is  the  common  access  routine  to  the  network  server.  net_access  is  an  internal 
libraty  call.  It  returns  the  error  code  provided  by  the  operating  system  the  library  is 
running  on.  h  is  the  access  handle  and  command  is  the  command  code  to  execute.  The 
command  specific  arguments  are  assumed  to  be  set  up  by  the  caller.  The  handle  is  assumed 
to  be  valid.  The  function  call  is  net_access(h,  command).  Table  2.20-185  describes  the 
parameters  used  and  functions  called  using  this  function  with  a  Butterfly  computer.  Table 
2.20-186  describes  the  parameters  used  and  functions  called  using  this  function  with  a 
Sun,  MIPS,  MSC  or  MassComp  computer. 
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Function 


net  alive 


net  res 


net  locontrol 


net  loopback 


net  oetaddr 


net  flush 


net  aet  statistics 


net  zero  statistics 


net  hostbuf  info 


net  bufs 


net  version 


do  mode  cmd  cmc 


net  oettime 


net  settime 


net  stomp  time 


net  load 


net  unload 


net  open 


net  aet  parameters 


net  set  parameters 


open  cmc 


e 


net  add  mca 


net  del  mca 


net  init  mca 


net  stamp  enable 


net  stamp  disable 


net  run 


net  sto 


recv  cnx: 


send  cmc 


recv  cmc  8023 


net  add  type 


net  init  type 


send  cmc  8023 


Where 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Called  B 


Described 


2.20.2.1.1. 


2.20.2.1.2. 


2.20.2.1.4. 


2.20.2.1.6. 


2.20.2.2.4. 


2.20.2.4.1. 


2.20.2.5.1. 


2.20.2.5.2. 


2.20.2.6.1. 


2.20.2.6.3. 


2.20.2.6.6. 


2.20.2.7.6. 


2.20.2.8.1. 


2.20.2.8.2. 


2.20.2.8.5. 


2.20.2.9.1. 


2.20.2.9.2. 


2.20.2.10.1. 


2.20.2.10.2. 


2.20.2.10.3. 


2.20.2.10.4. 


2.20.2.10.6. 


2.20.2.11.1. 


2.20.2.11.2. 


2.20.2.11.3. 


2.20.2.12.1. 


2.20.2.12.2. 


2.20.2.13.1. 


2.20.2.13.2. 


2.20.2.14.2. 


2.20.2.15.2. 


2.20.2.17.6. 


2.20.2.18.1. 


2.20.2.18.2. 


2.20.2.19.3. 


Table  2.20-185  Butterfly  net_access  Information. 


871 


BBN  Systems  and  Technologies 


MCC  CSCl 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

Unknown  NIF  type. 

ret 

int 

error  code 

I  Calls  I 

Function 

Where  Described 

access  cmc 

Section  2.20.2.20.2. 

access  147 

Section  2.20.2.20.3. 

1  Called  By  1 

Function 

Where  Described 

net  alive 

Section  2.20.2.1.1. 

net  res 

Section  2.20.2.1.2. 

net  iocontrol 

Section  2.20.2.1.4. 

net  loopback 

Section  2.20.2.1.6. 

net  qetaddr 

Section  2.20.2.2.4. 

net  flush 

Section  2.20.2.4.1. 

net  oet  statistics 

Section  2.20.2.5.1. 

net  zero  statistics 

Section  2.20.2.5.2. 

net  hostbuf  info 

Section  2.20.2.6.1. 

net  bufs 

Section  2.20.2.6.3. 

net  version 

Section  2.20.2.6.6. 

do  mode  cmd  cmc 

Section  2.20.2.7.6. 

net  aettime 

Section  2.20.2.8.1. 

net  settime 

Section  2.20.2.8.2. 

net  stomp  time 

Section  2.20.2.8.5. 

net  load 

Section  2.20.2.9.1. 

net  unload 

Section  2.20.2.9.2. 

net  open 

Section  2.20.2.10.1. 

net  qet  parameters 

Section  2.20.2.10.2. 

net  set  parameters 

Section  2.20.2.10.3. 

open  cmc 

Section  2.20.2.10.4. 

Section  2.20.2.10.6. 

net  add  mca 

Section  2.20.2.11.1. 

net  del  mca 

Section  2.20.2.11.2. 

net  init  mca 

Section  2.20.2.11.3. 

net  stamp  enable 

Section  2.20.2.12.1. 

net  stamp  disable 

Section  2.20.2  12.2. 

net  run 

Section  2.20.2.13.1. 

net  stop 

Section  2.20.2.13.2. 

recv  cmc 

Section  2.20.2.14.2. 

send  cmc 

Section  2.20.2.15.2. 

recv  cnic  8023 

Section  2.20.2.17.6 

net  add  type 

Section  2.20.2.18,1. 

net  init  type 

Section  2,20  2.18.2. 

send  cmc  8023 

Section  2  20.2.19.3. 

Table  2.20-186  Sun,  MIPS,  MSC  and  MassComp  nct  access  Information. 
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2.20.2.20.2  access_cmc 

access_cmc  retuns  the  access  code  to  the  cmc  card.  The  function  call  is  access_cmc(np, 
command).  Table  2.20-187  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

command 

int 

Standard  C  type. 

np 

pointer  to  struct  netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

errno 

int 

Unsuccessful.  Error  code  for 
error. 

0 

int 

Successful. 

1  Calls  1 

Function 

Where  Described 

XXX  OPEN 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

XXX  lOCTL 

Macro  defined  in  /simnet/libsrc/libnetif/libnet.h. 

1  Called  By  I 

Function 

Where  Described 

net  access 

Section  2.20.2.20.1. 

Table  2.20-187  access  cmc  Information. 


2.20.2.20.3  access  147 


access_147  is  not  supported  by  any  computers  used  in  SIMNET.  This  function  will 
always  return  0.  The  function  call  is  access_147(np).  Table  2.20-188  describes  the 
parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

_ 

pointer  to  struct  netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

Always  returned. 

Called  By 

Function 

Where  Described 

net  access 

Section  2.20.2.20.1. 

Table  2.20-188  access  147  Information. 
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2.20.2.21  net_stuf.c 

/sitnnet/libsrc/libneti^net_stuf.c 


None  of  the  following  functions  are  compiled  if  SIMBFLY  is  defined.  Table  2.20-189 
describes  the  variables  used  by  net_stuf.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

force  some  compilation 

int 

Standard  C  type. 

Table  2.20-189  net_stuf.c  Variable  Information. 

2.20.2.21.1  geMocks 

get_locks  gets  the  locks  for  the  rings.  It  does  nothing  and  always  returns  0  for  Sun,  MIPS 
and  MSC  computers  The  function  call  is  get_locks(np).  Table  2.20-190  describes  the 
parameters  usai  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

HR 

pointer  to  struct  netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful.  Always  returned 
for  Sun,  MIPS  and  MSC 
computers. 

I  Called  By  I 

Function 

Where  Described 

open  cmc 

Section  2.20.2.10.4. 

Table  2.20-190  geMocks  Information. 

2.20.2.21.2  map_buffers 

map_buffers  maps  in  the  buffers.  On  the  MassComp  it  attache.s  the  buffers,  while  on  the 
Sun  it  just  maps  them  in.  The  function  call  is  map_buffers(np,  flags).  Table  2.20- 1 9 1 
describes  the  parameters  used  and  functions  called  using  this  function  with  a  MassComp 
computer.  Table  2.20-192  describes  the  parameters  us^  and  functions  called  using  this 
function  with  a  MIPS  machine.  Table  2.20-193  describes  the  parameters  used  and 
functions  called  using  this  function  with  a  Sun.  Table  2.20-194  describes  the  parameters 
used  by  this  function  with  an  MSC. 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

np 

pointer  to  struct  netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

flaps 

int 

Standard  C  type. 

I  I 
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Variable 


tr 


Internal  Variables 


e 


inter  to  char 


Where  Tvoedef  Declared 


Standard  C  t 


Return  Value 


-1 


Return  Values 


Meaning 


Unsuccessful. 


Successful. 


Calls 

Function 

Where  Described 

attachshm 

Section  2.6.5.1.1  in  the  Vehicles  CSCI. 

Rinqsize  in  chars 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

Called  B 


Function 

Where  Described 

open  cmc 

Section  2.20.2.10.4. 

Table  2.20-191  MassComp  map_buffers  Information. 


Parameters 


Parameter 


flaos 


I  EH? 


inter  to  struct  netlib  pb 


Where  Tvoedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Standard  C  t 


R 


Variable 


tr 


lEH? 
IRS 


Internal  Variables 


e 


inter  to  char 


Where  Typedef  Declared 


Standard  C  type. 


Return  Value 


-1 


Return  Values 


Type 


int 


int 


Meanin 


Unsuccessful. 


Successful. 


Calls 

Function 

Where  Described 

Rinqsize  in  chars 

Macro  defined  in  /simnet/libsrc/libnetif/network.h. 

Function 


open  cmc 


Called  B 


Where  Described 


Section  2.20.2.10.4. 


Table  2.20-192  MIPS  map_buffers  Information. 
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Table  2.20*193  Sun  niap_buffers  Information. 


Parameter 


flaas 


Parameters 


inter  to  struct  netlibpb 


Where  Tvoedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Standard  C  tvoe. 


n 


variable 


tr 


idth: 

IIS 


Internal  Variables 


e 


inter  to  char 


Where  Tvoedef  Declared 


Standard  C  type. 


Return  Value 


0 


Return  Values 


Meanin 


Always  returned. 


Called  B 


Function 

Where  Described 

open  cmc 

Section  2.20.2.10.4. 

Table  2.20-J94  MSC  map  buffers  Information. 
2.20.2.21.3  mapenp 

map_enp  maps  in  the  CMC  card.  The  function  call  is  inap_enp(np).  Table  2.20- 195 
describe.s  the  parameters  u.sed  and  functions  called  using  this  function  with  a  Masscomp 
computer.  Table  2.20-  19ft  describes  the  parameters  used  by  this  function  with  r\  Sun, 
MIPS  or  MSC  computer. 


Parameter 


Parameters 


inter  to  struct  netiib  pb 


Where  Tvoedef  Declared 


/simnet/libsrc/libnef  if/libnef .  h 
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Table  2.20-195  MassComp  inap_enp  Information. 


Parameters 


Parameter 


where  Tvoedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


n 


Variable 


eno  base 


tr 


iBn 

m 

lltS 


Internal  Variables 


inter  to  char 


inter  to  char 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  type. 


Return  Values 


Return  Value 


0 


Type 


mt 


Meanin 


Always  returned. 


Function 


open  cmc 


Called  B 


Where  Described 


Section  2.20.2.10.4. 


Table  2.20-196  Sun,  MIPS  or  MSC  map_enp  Information. 


2.20.2.21.4 


unmap_enp 


unmap_enp  frees  up  the  memory  allocated  to  map  the  timer.  If  the  compuer  is  not  a 
MassComp  then  nothing  happens  but  0  is  still  returned.  The  function  call  is 
unmap_enp(np).  Table  2.20-197  describes  the  parameters  used  and  functions  called  using 
this  function. 


Parameter 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  struct  netlib  pb  /simnet/libsrc/libnetif/libnet.h 


Return  Values 


Return  Value 


Meanin 


Always  returned. 


Table  2.20-197  unmap_enp  Information. 


877 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.20.2.21.5  unmap_buffers 


unmap_buffers  undoes  the  action  of  Section  2.20.2.21 .2  map_buffers.  The  function  call 
is  unmap_buffers(np).  Table  2.20-198  describes  the  parameters  used,  eirors  returned  and 
functions  called  using  this  function  when  used  on  a  Mascomp  computer.  Table  2.20-199 
describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function  on  a 
Sun  or  a  MIPS. 


Parameter 


Parameters 


e 


inter  to  struct  netlib 


Return  Values 


Where  Tyoedef  Declared 


/simnet/libsrc/libnetif/libnet.h 


Return  Value 


Meanin 


Always  returned. 


Function 


detachshm 


Calls 


Where  Described 


Section  2.6.5.2.1  in  the  Vehicles  CSCI. 


Called  B 


Function 

Where  Described 

open  cmc 

Section  2.20.2.10.4. 

Table  2.20*198  MassComp  unmap_buffers  Information. 


Parameters 


Parameter 


inter  to  struct  netlib  ob 


Where  Typedef  Declared 


/simnet/libsrc/libnetit/libnet.h 


Return  Value 


-1 


Type 

Meaning 

int 

Successtul. 

int 

Unsuccesstul.  Call  to  munmap 
failed. 

Function 


ooen  cmc 


Called  B 


Where  Described 


Section  2.20.2.10.4, 


Table  2.20-199  Sun  and  MIPS  unmap  buffers  Information. 
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2.20.2.21.6 


ungeMocks 


ungetjocks  undoes  the  action  of  Section  2.20.2.21.1  get_locks.  The  function  call  is 
unget_locks(np).  Table  2.20-200  describes  the  parameters  used  by  this  f  inction. 


1  Parameters  | 

Parameter 

[Type _ 1 

Where  Typedef  Declared 

m. 

/simnet/libsrc/libnetif/libnet.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

Always  returned. 

1  Called  By  I 

Function 

Where  Described 

open  cmc 

Section  2.20.2.10.4. 

Table  2.20*200  ungeMocks  Information. 

2.20.2.22  net_data.c 

/simnet/libsrc/libnetif/net_data.c 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

statistics  strjnasfir4il 

matrix  of  char 

Standard  C  type. 

max  statistics  strinq 

int 

Standard  C  type. 

BroadcastAddress 

Network  Address 

/si  mnet/libsrc/li  bnetif/network , 
h 

FillinAddress 

NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

npb_space 

array  NUM_NETHANDLES  of 
struct  netlib  pb 

/simnet/libsrc/libnetif/libnet.h 

pointer  to  struct  netlib  pb 

/si  m  net/li  bsrc/libnetif/li  bnet .  h 

enpmapsize 

unsigned 

/u  sr/i  nclude/sys/sem .  h 

sem  unlock 

struct  sembuf 

/usr/include/SYS/sem.h 

sem  lock  wait 

struct  sembuf 

/usr/i  nclude/sys/sem. h 

sem  lock  nowait 

struct  sembuf 

/usr/include/sys/sem.h 

Table  2.20-201  net_data.c  Variable  Information. 

2.20.2.23  pktq.h 

/simnet/libsrc/libnetif/pktq.h  declares  the  structure  of  the  elements  of  the  queue  of  packets. 

2.20.2.24  network. h 

/simnet/libsrc/libnetif/network.h  contains  constants  and  declarations  for  using  libnetif.  This 
file  contains  the  public  interface  to  the  library. 

2.20.2.25  netlock.h 

/simnet/libsrc/libnetif/netlock.h  defines  macros  for  locking  and  unlocking  the  incoming 
queue  of  packets. 
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2.20.2.26  libnet.h 

/simnet/libsrc/libnetif/libnet.h  is  the  private  header  file  for  libnetif.  It  declares  and  defines 
constants,  macros,  types,  and  includes  for  libnetif. 

2.20.2.27  network.def 

The  netwoiic.(ief  file  specifies  the  configuration  of  the  network  interface.  This  file  is  read 
at  boot  time  and  each  restart  by  the  network  daemon.  Parameters  are  stored  in  the  driver 
and  obtained  via  library  calls  as  needed.  A  change  in  network.def  does  not  take  effect  until 
the  network  daemon  is  restarted.  If  the  size  of  any  memory  segment  is  changed  (such  as 
the  inring,  outring,  or  sharebuf)  the  shared  memory  should  be  removed  before  restarting 
the  network.  An  example  networkdef  file  is  shown  below: 

# 

#  network  definition  file 

# 

#  This  file  contains  data  that  defines  the  configuration  of 

#  the  SIMNET  network  interface. 

# 

device  enpO 
address  ffffffffffff 
inringkey  5 
iruingnum  32 
outringkey  6 
outringnum  4 
sharekey  7 
sharesize  4096 
xmtsemkey  4 
revsemkey  3 
hostbufsize  0 
multicast  64 

The  device  entry  specifies  the  network  interface  device  in  /dev. 

The  address  entry  specifies  the  ethernet  address  of  the  interface.  Any  multicast  address 
(such  as  the  broadcast  address)  directs  ihe  interface  to  use  its  ROMed  address. 

Tlie  inringkey  entry  specifies  the  shared  memory  key  to  use  for  the  receive  tinput)  ring. 

The  inringnum  entry  specifies  the  number  of  receive  ring  buffers. 

The  outringkey  entry  specifies  the  shared  memory  key  to  use  for  the  transmit  (output)  ring. 

TTie  outringnum  entry  specifies  the  number  of  transmit  ring  buffers 

The  sharekey  entry  specifies  the  shared  memory  key  to  use  for  the  sliarcd  memory  buffer. 
This  buffer  resides  in  the  host  and  is  accessible  to  the  application  and  the  code  running  on 
the  network  card. 

The  sharesize  entry  is  the  number  of  bytes  allocated  'o  the  shared  buffer. 

The  xmtsemkey  entry  specifies  the  seniiiphorc  key  u.scd  for  the  transnu:  ring  Icx  k 
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The  rcvsemkey  entry  specifies  the  semaphore  key  used  for  the  receive  ring  lock. 

The  hostbufsize  entry  reserves  a  segment  of  on-card  memory  for  host  use.  This  is  a  count 
in  bytes  for  the  nuymber  of  bytes  to  reserve. 

The  multicast  entry  specifies  the  number  of  multicast  addresses  that  the  card  can  support. 
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2.21  The  MCC  Libraries 


Figure  2.21-1:  MCC  Libraries. 


2.21.1  libmcc 

The  MCC  library  (libmcc)  provides  access  to  many  services  shared  among  and  throughout 
the  MCC  host  processes.  Abstract  data  types  simulator  tables,  ccv  status  entries  and 
supply  truck  tables  directly  support  the  MCC  simulation.  More  basic  ADTs  such  as  fast, 
hash  accessed  queues,  data  type  conversion  routines  and  protocol  interface  routines  provide 
flexible  and  efficient  front  ends  to  internal  data  structures. 


2.21.1.1  atatp.c 

/simnet/mcc/libmcc/atatp.c 

atatp.c  implements  an  AppleTalk  Transaction  Protocol.  The  AppleTalk  Transaction 
Protocol  dlows  MCC  host  processes  to  send  and  receive  AppleTalk  messages  to  and  from 
MCC  Macintosh  consoles.  The  protocol  provides  a  reliable  end-to-end  datagram  service 
between  sender  and  receiver.  A  shared  table  is  used  to  maintain  slate  information  on 
outstanding  transactions.  Table  2.21-1  describes  the  variables  used  by  atatp.c. 


1  Variables  | 

Variable 

Type 

Where  Typedef  Declared 

tid 

short 

Standard  C  type. 

activeTransactions 

pointer  to  array  of  Transaction 

/si  mnet/mcc/i  nclude/bridae .  h 

Table  2.21-1  atatp.c  Variable  Information. 
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2.21.1.1.1  ATPSendRequest 

ATPSendRequest  sends  an  ATP  Request  packet.  The  function  call  is  ATPSendRequest(t). 
The  function  is  void  so  there  are  no  errors  or  return  values.  Table  2.21-2  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

t 

1  reoister  oointer  to  Transaction  I 

/si  mnet/mcc/i  nclude/bridge.h 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

msg 

MCCMessageBuffer 

/simnet/rTX5C/include/MCC  ipc 
.h 

1  Calls 

Function 

Where  Described 

SendPacket 

See  Section  2.21.1.4.3. 

SetAlarm 

See  Section  2.21.2.4.2. 

ATPTimeout 

See  Section  2.21.1.1.3. 

1  Called  By 

Function 

Where  Described 

ATPTimeout 

See  Section  2.21.1.1.3. 

ATPRequest 

See  Section  2.21.1.1.4. 

Table  2.21-2  ATPSendRequest  Information. 


2.21.1.1.2  ATPSendResponse 


ATPSendResponse  sends  an  ATP  Response  packet.  The  function  call  is 
ATPSendResponse(t).  The  function  is  void  so  there  are  no  errors  or  return  values.  Table 
2.21-3  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

t 

register  pointer  to  Transaction 

/simnet/mcc/include/bridqe .  h 

1  Internal  Variables  | 

Variable 

Where  Typedef  Declared 

msg 

MCCMessageBuffer 

/simnet/rrx^include/MCC  ipc 
.h 

1  Calls  1 

Function 

Where  Described 

SendPacket 

See  Section  2.21.1.4.3. 

1  Called  By  1 

Function 

Where  Described 

ATPResponse 

See  Section  2.21.1.1.6. 

ATReceive 

See  Section  2.21.1.1.7. 

Table  2.21-3  ATPSendResponse  Information. 
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2.21.1.1.3  ATPTimeout 

ATPTimeout  is  called  when  a  timeout  expires.  The  function  call  is  ATPTimeout(param,  a). 
Table  2.21-4  describes  the  parameters  us^  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

param 

reqister  int 

Standard  C  type. 

a 

Alarm 

/simnet/rcs/libipc/alarm.h 

1  Internal  Variables  | 

Variable 

Where  Tvpedef  Declared 

i 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ATPSendRequest 

See  Section  2.21.1.1.1. 

ATFreeSocket 

See  Section  2.21.1.4.2. 

1  Called  Bv  1 

Function 

Where  Described 

ATPSendRequest 

See  Section  2.21.1.1.1. 

ATPResDonse 

See  Section  2.21.1.1.6. 

ATReceive 

See  Section  2.21.1.1.7. 

Table  2.21-4 


ATPTimeout  Information. 


2.21.1.1.4  ATPRequest 


ATPRequest  sends  an  ATP  request.  It  places  the  transaction  in  the  active  transaction  table, 
allocates  a  socket,  constructs  the  ATP  Request  packet,  sends  the  packet  and  starts  a  retry 
timeout  alarm.  The  function  call  is  ATPRequest(t,  priority).  Table  2.21-5  describes  the 
parameters  used,  errors  returned  and  functions  call^  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

register  pointer  to  Transaction 

/si  mnet/mcc/include/bridqe .  h 

priority 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

bp 

register  pointer  to  char 

Standard  C  type. 

i 

int 

Standard  C  type. 

Errors 

Error  Name 

Reason  for  Error 

MCC  TOO  MANY  TRANS 
ACTIONS 

The  active  transaction  table  is  full. 
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1  Calls  1 

Function 

Where  Described 

ATAIIocSocket 

See  Section  2.21.1.4.1. 

ATPSendRequest 

See  Section  2.21.1.1.1. 

Called  By 

Function 

Where  Described 

ATPTransact 

See  Section  2.21.1.7.3. 

ATPPut 

See  Section  2.21.1.7.4. 

Table  2.21-5  ATPRequest  Information. 

2.21.1.1.5  ATPGetRequest 

ATPGetRequest  prepares  to  receive  a  request  on  a  socket.  The  function  call  is 
ATPGetRequest(t).  Table  2.21-6  descries  the  parameters  used  and  errors  returned  using 
this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

reqister  pointer  to  Transaction 

/simnet/mcc/i  nclude/bridqe  .h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

1  Errors  1 

Error  Name 

Reason  for  Error 

MCC  TOO  MANY  TRANS 
ACTIONS 

The  active  transaction  table  is  full. 

1  Called  By  1 

Function 

Where  Described 

OpenHostSocket 

See  Section  2.21.1.7.1. 

ConsoleReleaseArrived 

See  Section  2.21.1.7.7. 

Table  2.21-6  ATPGetRequest  Information. 

2.21.1.1.6  ATPResponse 

ATPResponse  sends  a  response  to  a  transaction  request.  It  constructs  and  sends  an  ATP 
Response  packet  and  restarts  a  release  timer  if  it  is  an  exactly-once  transaction.  The 
function  call  is  ATPResponse(t).  Table  2.21-7  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

t 

reqister  pointer  to  Transaction 

/simnet/mcc/i  nclude/bridqe .  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

bfi _ 

reqister  pointer  to  char 

Standard  C  type. 
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Calls 

Function 

Where  Described 

ATPSendResponse 

See  Section  2.21.1.1.2. 

CancelAlarm 

See  Section  2.21.2.4.3. 

SetAlarm 

See  Section  2.21.2.4.2. 

ATPTimeout 

See  Section  2.21.1.1.3. 

Called  B 


Function 

Where  Described 

SendConsoleResponse 

See  Section  2.21.1.7.6. 

Table  2.21>7  ATPResponse  Information. 

2.21.1.1.7  ATReceive 

ATReceive  processes  a  packet  received  from  the  AppleTalk  network.  This  routine  is  called 
when  a  YUMM  message  bearing  a  DDP  packet  arrives  from  the  Appletalk  Network.  The 
function  call  is  ATReceive(type,  kind,  length,  data,  reqlD).  Table  2.21-8  describes  the 
parameters  used,  errors  returned  and  functions  called  using  this  function. 


Parameters 


Parameter 


e 


lenoth 


kind 


reqlD 


data 


reoister  pointer  to  char 


Where  Tynedef  Declared 


Standard  C  tvoe. 


Standard  C  tvpe. 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Variable 


bp 


t 


alarmsEnabled 


ccFieid 


seqField 


tidField 


Internal  Variables 


e 


register  pointer  to  char 


register  pointer  to  Transaction 


int 


short 


short 


short 


short 


register  pointer  to  char 


Where  Typedef  Declared 


Standard  C  t 


/simnet/mcc/include/bridge.  h 


Standard  C  type.  _ 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Errors 

Error  Name 

Reason  for  Error 

MCC  UNEXPECTED  MESS 
AGE 

Unexpected  messago 

MCC  BAD  ATALK  PACKET 

Invalid  AppleTalk  packet  received 

MCC  ORPHAN  REQUEST 

ATP  Request  discarded. 

MCC  ORPHAN  RESPONSE 

ATP  Response  discarded. 

MCC  RESPONSE  SEQ  NU 
MBER 

ATP  Response  has  non-:'ero  sequence  number 

MCC  ORPHAN  RELEASE 

ATP  Release  discarded. 
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Calls 

Function 

Where  Described 

TraceMessaae 

See  Section  2.21.1.19.3. 

AlarmsEnabled 

See  Section  2.21.2.4.4. 

ATFreeButfer 

See  Section  2.21.1.2.2. 

ATPSendResponse 

See  Section  2.21.1.1.2. 

CancelAlarm 

See  Section  2.21.2.4.3. 

SetAlarm 

See  Section  2.21.2.4.2. 

ATPTimeout 

See  Section  2.21.1.1.3. 

ATAllocBuffer 

See  Section  2.21.1.2.1. 

SendPacket 

See  Section  2.21.1.4.3. 

ATFreeSocket 

See  Section  2.21.1.4.2. 

Cailed  B 


Function 

Where  Described 

OpenHostSocket 

See  Section  2.21.1.7.1. 

Table  2.21-8  ATReceive  Information. 


2.21.1.2  atbuf.c 

/simnet/mcc/libmcc/atbuf.c 

atbuf.c  implements  buffer  management  in  shared  memory  for  AppleTalk  datagrams. 

2.21.1.2.1  ATAllocBuffer 

ATAllocBuffer  obtains  an  AppleTalk  buffer  from  the  shared  pool.  The  function  call  is 
ATAllocBuffer().  Table  2.21-8  describes  the  parameters  us^,  return  values  and  possible 
errors  generated  by  using  this  function. 


_  Internal  Variables  _ 

Variable _ Type _ Where  Typedef  Declared 

but_ register  int_ Standard  C  type.  


_ _ Return  Values _ _ 

Return  Value _ Type _ _ Meaning _ 

-1  int  operation  tailed,  ermo  set  to 

_ indicate  error _ 

but  int  successful 


Errors 


Error  Name _ Reason  for  Error _ 

MCC  NO  BUFFER_ No  AppleTalk  butter  in  the  shared  pool. 


Calls 

Function 

Where  Described 

Lock 

See  Section  2.21.2.6.3. 

Unlock 

See  Section  2.21.2.6.4. 
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1  Called  By  I 

Function 

Where  Described 

ATReceive 

See  Section  2.21.1.1.7. 

NBPLookup 

See  Section  2.21.1.3.1. 

ATPTransact 

See  Section  2.21.1.7.3. 

ATPPut 

See  Section  2.21.1.7.4. 

Table  2.21-9  ATAIIocBuffer  Information. 

2.21.1.2.2  ATFreeBuffer 

ATFreeBuffer  returns  an  AppleTalk  buffer,  birf,  to  the  shared  pool.  The  function  call  is 
ATFreeBuffer(buf).  Table  2.21-10  describes  the  parameters  used  and  possible  errors 
generated  by  using  this  function. 


j  Parameters  | 

Parameter 

Where  Typedef  Declared 

but 

int 

Standard  C  type. 

1  Errors  I 

Error  Name 

Reason  for  Error 

MCC  BUFFER  FREE 

Buffer  not  marked  as  in  use. 

1  Called  By  I 

Function 

Where  Described 

ATReceive 

See  Section  2.21.1.1.7. 

NBPLookup 

See  Section  2.21.1.3.1. 

NBPReceive 

See  Section  2.21.1.3.2. 

ATPTransact 

See  Section  2.21.1.7.3. 

ATPPutComplete 

See  Section  2.21.1.7.5. 

ConsoleReleaseArrived 

See  Section  2.21.1.7.7. 

Table  2.21-10  ATFreeBuffer  Information. 

2.21.1.3  atnbp.c 

/simnel/mcc/libmcc/atnbp.c 

atnbp.c  implements  a  simple  name  lookup  on  the  AppleTalk  Network.  This  module  is  used 
to  lookup  the  address  of  the  objects  on  the  AppleTalk  Network  which  are  associated  with 
MCC  Macintosh  consoles  so  that  those  objects  may  communicate  with  the  MCC  host 
system.  Table  2.21-1 1  describes  the  variables  us^  by  atnbp.c. 


1  Variables  | 

Variable 

Type 

Where  Typedef  Declared 

a 

pointer  to  ATalk Address 

/simnet/mcc/include/at  addr.h 

replyReceived 

int 

Standard  C  type 

Table  2.21-11  atnbp.c  Variable  Information. 
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2.21.1.3.1  NBPLookup 


NBPLookup  looks  up  an  entity  name  and  returns  its  address.  This  function  implements  a 
very  limited  name  lookup.  At  most,  one  matching  address  will  be  found.  Retry  interval 
and  count  are  fixed.  The  function  call  is  NBPLookup(ojbStr,  typeStr,  zoneStr,  a).  Table 
2.21-12  describes  the  parameters  used,  internal  variables  used,  and  functions  called  by 
using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

obiStr 

pointer  to  char 

Standard  C  type. 

tvpeStr 

pointer  to  char 

Standard  C  type. 

zoneStr 

pointer  to  char 

Standard  C  type. 

a 

pointer  to  ATalkAddress 

Standard  Appletalk. 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

bp 

register  pointer  to  char 

Standard  C  type. 

ddpSocket 

int 

Standard  C  type. 

retry 

int 

Standard  C  type. 

timeLeft 

int 

Standard  C  type. 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

Return  Values 

Return  Value 

Type 

Meaning 

replyReceived 

int 

Address  of  entity 

1  Calls  1 

Function 

Where  Described 

ATAIIocSocket 

See  Section  2.21.1.4.1. 

ATAIIocBuffer 

See  Section  2.21.1.2.1. 

SendPacket 

See  Section  2.21.1.4.3. 

ATFreeSocket 

See  Section  2.21.1.4.2. 

ATFreeBuffer 

See  Section  2.21.1.2.2. 

1  Called  By  I 

Function 

Where  Described 

ActivateConsole 

See  Section  2.21.1.7.2. 

Table  2.21-12  NBPLookup  Information. 

2.21.1.3.2  NBPReceive 

NBPReceive  handles  an  incomming  LkUp-Reply  packet.  The  function  checks  to  see  that 
the  message  is  from  the  AppleTalk  network  and  that  the  packet  is  an  NBP  packet.  It  also 
checks  to  see  that  it  is  a  LkUp-Reply  packet  and  extracts  is  entity  address.  The  function 
call  is  NBPReceive(type,  kind,  length,  data,  reqlD).  Table  2.21-13  describes  the 
parameters  used,  errors  returned  and  functions  called  using  this  function. 
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1  Parameters  I 

1  Parameter 

Where  Typedef  Declared 

int 

Standard  C  type. 

length 

int 

Standard  C  type. 

kind 

long 

Standard  C  type. 

regID 

long 

Standard  C  type. 

data 

register  pointer  to  char 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

bp 

register  pointer  to  char 

Standard  C  type. 

1  Errors  I 

Error  Name 

Reason  for  Error 

MCC  UNEXPECTED  MESS 
AGE 

Unexpected  message. 

MCC  BAD  ATALK  PACKET 

Invalid  AppleTalk  packet  received. 

1  Calls  1 

Function 

Where  Described 

TraceMessage 

See  Section  2.21.1.19.3. 

ATFreeBuffer 

See  Section  2.21.1.2.2. 

Table  2.21-13  NBPReceive  Information. 


2.21.1.4  atskt.c 

/simnet/mcc/libmcc/atskt.c 

atskt.c  manages  allocation  and  deallocation  of  data  pathways  to  the  AppleTalk  network. 
Unix  sockets  are  used  to  communicate  with  the  ATRecv  and  ATSend  processes  which 
encapsulate  the  actual  messages  into  AppleTalk  packets. 

2.21.1.4.1  ATAIIocSocket 

ATAllocSocket  obtains  an  AppleTalk  DDP  socket.  A  YUMM  socket  is  opened  and 
associated  with  the  DDP  socket.  The  function  call  is  ATAllocSocket(handler,  priority). 
Table  2.21-14  describes  the  parameters  used,  errors  returned  and  functions  called  using 
this  function. 


Parameters 


Parameter _ Type _ Where  Typedef  Declared 

handler  pointer  to  a  void  function  Standard  C  type. 


Variable _ Type _ Where  Typedef  Declared 

s _ register  int _ Standard  C  type. _ 

msgSocket_ YUMMSocket /simnet/rcs/libipc^yumrn.h 
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Return  Values 


Return  Value 


s 


Meanin 


DDP  socket  number 


Errors 

Error  Name 

Reason  for  Error 

MCC  SOCKET  TABLE  FUL 

L 

Socket  table  full. 

Function 


OpenSocket 


Lock 


Unlock 


Calls 


Where  Described 


See  Section  2.21.2.10.3. 


See  Section  2.21.2.6.3. 


See  Section  2.21.2.6.4. 


Function 


ATPReauest 


NBPLooku 


OpenHostSocket 


Called  B 


Where  Described 


See  Section  2.21.1.1.4. 


See  Section  2.21.1.3.1. 


See  Section  2.21.1.7.1. 


Table  2.21-14  ATAIIocSocket  Information. 

2.21.1.4.2  ATFreeSocket 

ATFreeSocket  releases  an  AppleTalk  DDP  socket,  skt.  The  function  call  is 
ATFreeSocket(skt).  Table  2.21-15  describes  the  parameters  used,  errors  returned  and 
functions  called  using  this  function. 


Parameters 

Parameter 

EiT!] 

e 

Where  Typedef  Declared 

skt 

1  int  1 

Standard  C  type. 

Variable 


Internal  Variables 


e 


reoister  pointer  to  char 


Where  Typedef  Declared 


Standard  C  type. 


Error  Name 


MCC  SOCKET  NOT  OPEN 


Errors 


Reason  for  Error 


Socket  is  not  in  use. 


Calls 

Function 

Where  Described 

CloseSocket 

See  Section  2.21.2.10.4. 

Function 


ATPTimeout 


ATReceive 


NBPLooku 


Called  B 


Where  Described 


See  Section  2.21.1.1.3. 


See  Section  2.21.1.1.7. 


See  Section  2.21.1.3.1. 


Table  2.21-15  ATFreeSocket  Information. 
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2.21.1.4.3  SendPacket 

SendPacket  sends  a  packet  on  the  AppleTalk  network.  The  function  call  is 
SendPacket(msg).  Table  2.21-16  describes  the  parameter  used  and  function  called  using 
this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

msg 

pointer  to  MCCMessageBufter 

/simnet/mcc/include/MCC  ipc 
.h 

1  Calls  1 

Function 

Where  Described 

SendMCCMsql 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

1  Called  Bv  1 

Function 

Where  Described 

ATPSendReauest 

See  Section  2.21.1.1.1. 

ATPSendResponse 

See  Section  2.21.1.1.2. 

ATReceive 

See  Section  2.21.1.1.7. 

NBPLookuo 

See  Section  2.21.1.3.1. 

Table  2.21-16  SendPacket  Information. 

2.21.1.5  azimuth. c 

/simnet/mccAibmcc/azimuth  .c 

arimuth.c  provides  conversion  from  32  bit  fixed  point  fraction  of  a  circle  to  mils  and  vice 
versa. 


2.21.1.5.1  mil_to_fixedpt 

mil_to_fixedpt  converts  mils  to  a  32  bit  fixed  point  fraction  of  a  circle.  The  function  call  is 
mil_to_fixedpt(mils).  Table  2.21-17  describes  the  parameters  used.intemal  variables  used, 
and  return  values  generated  by  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

mils 

unsigned  short 

Standard  C  type. 

I  Internal  Variables  | 

Variable 

Type 

Where  Typedef  Declared 

pts 

Standard  C  type. 

I  Return  Values  I 

Return  Value 

Meaning 

pts 

unsigned  long 

32  bit  fixed  point  fraction  of  a 
circle 

Table  2.21-17  mil  to  fixedpt  Information. 
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2.21.1.5.2  fixedpt_to_inil 

fixedpt_to_mil  converts  a  32  bit  fixed  point  fraction  of  a  circle  to  mils.  The  function  call  is 
fixedpt_to_mil(pts).  Table  2.21-18  describes  the  parameters  used,  internal  variables  used, 
and  return  values  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pts 

unsianed  Iona 

Standard  C  type. 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

mils 

unsianed  short 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

mils 

unsianed  short 

the  value  of  the  circle  in  mils 

1  Called  Bv  1 

Function 

Where  Described 

ProcessSimQueryRequest 

See  Section  2.21.1.25.4. 

Table  2.21-18  fixedpt_to_miI  Information. 

2.21.1.6  ccv.c 

/simnet/mcc/libmcc/ccv.c 

ccv.c  handles  requests  from  Macintoshes  to  place  and  remove  computer  controlled  vehicles 
from  the  terrain.  These  routines  package  up  the  Macintosh  requests  and  forward  them  on 
to  the  controlling  MCC  host  process. 


2.21.1.6.1  DisplayCCV 


DisplayCCV  makes  a  computer-controlled  vehicle  visible  on  the  terrain.  A  message  is  sent 
to  the  Mother  process  and  if  the  vehicle  is  placed,  the  data  in  the  vehicle  table  will  be 
changed  to  reflect  its  actual  location.  The  function  call  is  DisplayCCV(vehicIe,  type, 
alignment,  role,  company,  loc,  azimuth).  Table  2.21-19  describes  the  parameters  used, 
errors  returned  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

vehicle 

unsigned  short 

Standard  C  type. 

guises 

pointer  to  VehicleGuises 

/simnet/common/include/prot 

ocolbasic.h 

unit 

pointer  to  OrganizationalUnit 

/simnet/common/include/prot 

ocolbasic.h 

marking 

pointer  to  VehicleMarking 

/simnet/common/include/prot 

ocolbasic.h 

capabilities 

VehicleCapabilities 

/simnet/common/include/prot 

ocolbasic.h 

loc 

pointer  to  LongR 

/simnet/common/include/glob 

al/lonqpt.h 

azimuth 

short 

Standard  C  type. 
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1  Internal  Variables  I 

Variable 

Where  Tvpedef  Declared 

msg 

MCCMessageBuffer 

/simne/mcc/include/MCC  ipc. 
h 

respKind 

Iona 

Standard  C  type. 

respLen 

int 

Standard  C  type. 

errCode 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

Transact 

See  Section  2.21.2.10.9. 

Table  2.21-19  DisplayCCV  Information. 


2.21.1.6.2  HideCCV 


HideCCV  makes  a  computer-controlled  vehicle,  vehicle,  invisible.  The  function  call  is 
HideCCV(vehicle).  Table  2.21-20  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

vehicle 

unsigned  short 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

1  Calls  1 

Function 

Where  Described 

SendMCCMsgl 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

Table  2.21-20  HideCCV  Information. 


2.21.1.7  console. c 

/simnet/mcc/libmcc/console.c 

This  module  forms  the  high  level  interface  mechanism  used  by  MCC  host  processes  to 
communicate  with  the  Macintosh  consoles  they  control.  It  provides  a  transaction  based 
communication  mechanism  through  the  other  lower  level  transaction  services.  Table 
2.21-21  describes  the  variables  used  by  console.c. 


1  Variables  I 

Variable 

Where  Typedef  Declared 

hostSocket 

int 

Standard  C  type. 

(requestHandler)() 

function  that  returns  int 

Standard  C  type. 

(responseHandlerjO 

function  that  returns  int 

Standard  C  type 

trans 

pointer  to  Transaction 

/simnet/mcc/include/bridge.h 

Table  2.21-21  console.c  Variable  Information. 
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2.21.1.7.1  OpenHostSocket 

OpenHostSocket  opens  a  socket  that  the  host  console  process  will  use  to  receive  requests. 
First  a  socket  is  allocated  through  which  requests  may  be  received  and  then  asynchronous 
ATP  GetRequests  are  queued  up.  The  function  call  is  C>penHostSocket(reqHdler, 
rspHdler).  Table  2.21-22  describes  the  parameters  used  and  functions  call^  using  this 
function. 


Parameter 


reqHdIer 


rspHdler 


Parameters 


e  Where  Typedef  Declared 


pointer  to  function  that  returns  Standard  C  type, 
int 


pointer  to  function  that  returns  Standard  C  type, 
int 


Variable 


Internal  Variables 


e 


reoister  mt 


Where  Tvoedef  Declared 


Standard  C  type. 


Calls 

Function 

Where  Described 

ATAIIocSocket 

See  Section  2.21.1.4.1. 

ATReceiye 

See  Section  2.21.1.1.7. 

ATPGetRequest 

See  Section  2.21.1.1.5. 

Table  2.21*22  OpenHostSocket  Information. 

2.21.1.7.2  ActivateConsole 

ActivateConsole  activates  the  Macintosh  console,  console.  The  name  of  the  console  on  the 
AppleTalk  network  is  looked  up  and  then  a  Consoles  tartUp  request  is  sent.  The  function 
call  is  ActivateConsole(console).  Table  2.21-23  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

console 

1  int  1 

Standard  C  type. 

Variable 


start 


Internal  Variables 


Conso  leStartUpRequ  est 


Where  Typedef  Declared 


/simnet/mcc/include/console. 

h 


Errors 


Error  Name  Reason  for  Error 


MCC_MAC_NOT_RESPONDI  Mac  not  responding.  It  will  retry  in  30  seconds. 
NG 


MCC  STARTUP  FAILED  I  Start  up  failed.  It  will  retry  in  30  seconds. 
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1  Calls  1 

Function 

Where  Described 

AlarmsEnabled 

See  Section  2.21.2.4.4. 

NBPLookup 

See  Section  2.21.1.3.1. 

MacintoshTime 

See  Section  2.21.1.27.1. 

ATPTransact 

See  Section  2.21.1.7.3. 

Table  2.21-23  ActivateConsoIe  Information. 


2.21.1.7.3  ATPTransact 

ATPTransact  sends  an  ATP  request  and  gets  a  response.  The  function  call  is 
ATPTransact(console,  code,  req,  reqLength,  rsp,  rspLength,  xo).  Table  2.21-24  describes 
the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


Parameters 


Parameter 


console 


code 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Variable 


t 


alarmsEnabled 


result 


Internal  Variables 


Transaction 


int 


int 


Where  Tvoedef  Declared 


/simnet/mcc/include/bridge.h 


Standard  C  type. 


Standard  C  type. 


Return  Value 


result 


Return  Values 


Meanin 


It  result  =  0 ,  the  transction  was 
not  successful.  Otherwise 
result  equals  t  rspLength  - 
atpHdsz 


Error  Name 


MCC  BAD  RESPONSE 


Errors 


Reason  for  Error 


Incorrect  response  from  Macintosh. 


Function 


AlarmsEnabled 


ATAIIocBuffer 


ATPReauest 


ATFreeBuffer 


Calls 


Where  Described 


See  Section  2.21.2.4.4 


See  Section  2.21.1.2.1. 


See  Section  2.21.1.1.4. 


See  Section  2.21.1.2.2. 
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1  Called  By  1 

r 

Function 

Where  Described 

t 

ActivateConsole 

See  Section  2.21.1.7.2. 

Table  2.21-24  ATPTransact  Information. 


2.21.1.7.4  ATPPut 


ATPPut  sends  an  ATP  Request  to  a  console,  not  waiting  for  the  response.  The  function 
call  is  ATPPut(console,  code,  req,  reqLength,  xo).  Table  2.21-25  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

console 

int 

Standard  C  type. 

code 

lonq 

Standard  C  type. 

req 

pointer  to  char 

Standai  J  C  type. 

reqLenqth 

int 

Standard  C  type. 

xo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bri  dq  e .  h 

Calls 

Function 

Where  Described 

ATAIIocBuffer 

See  Section  2.21.1.2.1. 

ATPPutComplete 

See  Section  2.21.1.7.5. 

ATPRequest 

See  Section  2.21.1.1.4. 

Table  2.21-25  ATPPut  Information. 


2.21.1.7.5  ATPPutCompIete 


ATPPutComplete  is  the  completion  routine  for  ATPPut.  It  is  called  if  a  response  has  been 
received  or  the  transaction  has  timed  out.  The  function  call  is  ATPPutComplete(t).  Table 
2.21-26  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

1  Calls  1 

Function 

Where  Described 

ATFreeBuffer 

See  Section  2.21.1.2.2. 

1  Called  By  1 

Function 

Where  Described 

ATPPut 

See  Section  2.21.1.7.4. 

Table  2.21-26  ATPPutComplete  Information. 
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2.21.1.7.6  SendConsoleResponse 

SendConsoleRequest  sends  an  ATP  Response  to  a  console.  The  function  call  is 
SendConsoleResponse(t,  size).  Table  2.21-27  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

reqister  pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

size 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

ATPResponse 

See  Section  2.21.1.1.6. 

Called  By 

Function 

Where  Described 

Process  GridInfoRequest 

See  Section  2.21.1.16.1. 

ProcessSimExistsRequest 

See  Section  2.21.1.25.1. 

ProcessSimlnitRequest 

See  Section  2.21.1.25.2. 

ProcessSimQuervRequest 

See  Section  2.21.1.25.4. 

Table  2.21*27  SendConsoleResponse  Information. 
2.21.1.7.7  ConsoleReleaseArrived 


ConsoleReleaseArrived  is  called  on  arrival  of  an  ATP  Release  packet,  t,  signifying 
completion  of  a  transaction.  The  function  call  is  ConsoleReleaseArrived(t).  Table  2.21-28 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

1  Calls  1 

Function 

Where  Described 

ATFreeBuffer 

See  Section  2.21.1.2.2. 

ATPGetRequest 

See  Section  2.21.1.1.5. 

Table  2.21-28  ConsoleReleaseArrived  Information. 

2.21.1.8  cew.c 

/simnet/mcc/libmcc/cew.c 

cew.c  contains  a  routine  for  accessing  the  CEW  asset  parameters  in  shared  memor\'. 

2.21.1.8.1  GetCEWParameters 


GetCEWParameters  finds  the  CEWParameters  object  in  shared  memory  corresponding  to  a 
particular  asset.  The  function  call  is  GetCEWParameters(kind,  assetNumber).  Table 
2.21-29  describes  the  parameters  used  and  errors  returned  using  this  function 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

kind 

short 

Standard  C  type. 

assetNumber 

short 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

pars 

register  pointer  to 
CEWParameters 

/simnet/mcc/include/MCC _par 
s.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

pars  +  assetNumber 

pointer  to  CEWParameters 

CEWParameters  object  in 
shared  memory  that 
corresponds  the  the  asset 
specified  by  assetNumber 

1  Errors  I 

Error  Name 

Reason  for  Error 

MCC  TRUCK  BADPARM 

Bad  truck  parameter. 

Table  2.21-29  GetCEWParameters  Information. 


2.21.1.9  data.c 

/simnet/mcc/libmcc/data.c 


This  module  defines  global  data  segments  shared  among  all  processes.  Table  2.21-30 
shows  the  variables  defined  in  data.c. 


1  Variables  I 

1  Variable  1 

Type 

Where  Typedef  Declared 

pointer  to  char 

Standard  C  type. 

authors 

pointer  to  char 

Standard  C  type. 

mcc 

pointer  to  MCCParameters 

/simnet/mcc/include/MCC_Par 

s.h 

vehicles 

pointer  to  VehicleTable 

/simnet/mcc/include/veh_tabl 

e.h 

vList 

pointer  to  FQueue  Head  t 

/simnet/mcc/libmcc/fqueue.h 

vStatusList 

pointer  to  FQueue  Head  t 

/simnet/mcc/libmcc/fqueue.h 

aTalk 

pointer  to  ATalkInlo 

/simnet/mcc/include/bridge.h 

thisProcess 

int 

Standard  C  type. 

mccSemaphores 

int 

Standard  C  type. 

Table  2.21-30  data.c  Information. 


899 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.21.1.10  decode.c 

/simnet/mcc/libmcc/decode.c 

decode.c  contains  routines  for  dealing  with  rotation  matrices. 

2.21.1.10.1  DecodeHuIlT  oWorldMatrix 


DecodeHullToWorldMatrix  derives  a  rotation  about  each  of  three  axes  from  the  hull  to 
world  transformation  matrix.  The  function  call  is  D€x:odeHullToWorldMatrix(m,  rot). 
Table  2.21-31  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

mf31f31 

float 

Standard  C  tvoe. 

rotr31 

ftoat 

Standard  C  type. 

Internal  Variables 

Variable 

Tvoe 

Where  Typedef  Declared 

d 

double 

Standard  C  type. 

1  Called  By  I 

Function 

Where  Described 

ProcessSimOuervRequest 

See  Section  2.21.1.25.4. 

Table  2.21*31  DecodeHullToWorldMatrix  Information. 


2.21.1.10.2  DecodeRotationVector 


DecodeRotationVector  decodes  a  vector,  v,  composed  of  sine  and  cosine  into  a  single  angle 
in  the  range  of  -PI  to  4-PI  radians.  The  function  call  is  DecodeRotationVector(v).  Table 
2.21-32  describes  the  parameters  used  by  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

V 

array  of  2  float 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

f 

float 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

f 

float 

Angle  of  vector. 

Table  2.21-32  DecodeRotationVector  Information. 
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2.21.1.11  error.c 

/simnet/mcc/libmcc/error.c 

The  MCC  takes  advantage  of  exception  handling  under  RTU  V4.0A  Unix  in  order  to 
display  and  report  erroneous  or  interesting  behavior  during  the  course  of  an  exercise.  The 
exception  handler  traps  all  exceptions  generated  by  the  MCC.  Table  2.21-33  shows  the 
external  variables  used  by  error.c. 


1  External  Variables  I 

Variable 

Where  Typedef  Declared 

errno 

extern  int 

Standard  C. 

severity 

extern  int 

Standard  C. 

svs  nerr 

extern  int 

Standard  C. 

sys.erriist 

extern  pointer  to  array  of  char 

Standard  C. 

Table  2.21-33  error.c  External  Variable  Information. 


2.21.1.11.1  InitErrorHandling 


InitErrorHandling  initializes  a  process’s  handling  of  errors.  The  function  call  is 
InitErrorHandling(progname).  l  able  2.21-34  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

proqname 

pointer  to  char 

Standard  C  type. 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

str 

array  of  30  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

MCC  errinit 

See  Section  2.21.1.33.1. 

1  Called  By  I 

Function 

Where  Described 

InitializeProcess 

See  Section  2.21.1.19.1. 

Table  2.21-34  InitErrorHandling  Information. 
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2.21.1.11.2  SendErrorReport 


SendErrorReport  sends  an  Error  Report  PDU,  which  is  of  interest  to  the  NOM  system. 

The  function  call  is  SendErrorReport().  Table  2.21-35  describes  the  internal  variables  used 
and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

buff 

array  of  maxNetworkPDUSize 
char 

Standard  C  type. 

mPDU 

pointer  to  ManagementPOU 

/simnet/comrrwn/include/prot 
ocol/p  mgmt.h 

errorVariant 

pointer  to  ErrorReportVariant 

/simnet/common/include/prot 
ocol/p  mgmt.h 

errorTexf 

array  of  513  char 

Standard  C  type. 

max  err  len 

unsigned  int 

Standard  C  type. 

mSize 

unsigned  short 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

severity 

int 

The  severity  of  the  error  code. 

1  Calls  1 

Function 

Where  Described 

MGMT  HDR  SIZE 

macro  defined  in  /simnet/common/include/protocol/p  mgmt.h 

Table  2.21-35  SendErrorReport  Information. 


2.21.1.11.3  MCC_SystemError 

MCC_SystemError  reports  an  error  encountered  in  a  system  call.  functiotiName  is  the 
name  of  the  function  you  are  currently  in  and  systemCallName  is  the  name  of  the  system 
call  tht  caused  the  error.  The  function  call  is  MCC_SystemError(functionName, 
systemCallName).  Table  2.21-36  describes  the  parameters  used  and  errors  returned  using 
this  function. 
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1  Called  By  I 

Function 

Where  Described 

OpenNetworkInterface 

See  Section  2.21.1.22.3. 

Spawn  Process 

See  Section  2.21.1.26.1. 

Table  2.21-36  MCC  SystemError  Information. 


2.21.1.11.4  VehicIelDToTrailer 

VehiclelDToTrailer  returns  an  ASCII  string  identifying  a  vehicle.  This  routine  returns  a 
string  of  the  form  <trailerxelement>,  given  a  vehicle  number,  vehiclelD.  If  the  simulator 
is  not  one  of  ours,  “unknown”  is  returned.  Ute  returned  suing  is  in  storage  internal  to  this 
routine.  The  function  call  is  VehicleIDToTrailer(vehicleID).  Table  2.21-37  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

vehiclelD 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

Internal  Variables 

Variable 

Type 

1  Where  Typedef  Declared  I 

Sim 

register  pointer  to 
SimulatorStatus 

veh 

register  pointer  to 
VehiclelDStatus 

/simnet/mcc/include/vehjabi 

e.h 

buffer 

array  of  10  char 

Standard  C  type. 

unknown 

pointer  to  char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

buffer 

pointer  to  char 

String  identifying  vehicle. 

unknown 

pointer  to  char 

String  identifying  vehicle. 

1  Calls  1 

Function 

Where  Described 

FQueue.  Retrieve 

See  Section  2.21.1.13.7. 

Table  2.21-37  VehiclelDToTrailer  Information. 

2.21.1.12  faad.c 

/simnet/mcc/libmcc/faad.c 


Forward  Area  Air  Defense  vehicles  (FAAD)  have  specific  status  information  relating  to 
parameters  such  as  fuel  and  armament.  This  module  decodes  and  encodes  FAAD  status 
information  for  communication  between  the  MCC  host  process  and  the  SCC  Macintosh 
console. 


903 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.21.1.12.1 


EncodeVehicleStatusFAAD 


EncodeVehicleStatusFAAD  builds  an  FAAD  VehicleSpecificStatus  structure  from  data 
supplied  by  the  SCC  or  Place  console.  The  function  c^l  is 

EncodeVehicleStatusFAAD(loc,  vss).  Table  2.21-38  describes  the  parameters  usedby  this 
function. 


Parameter 


loc 


Parameters 


e 


pointer  to  SimVehicleStatus 


VehicleSpecificStatus 


Where  Typedef  Declared 


/SI  mnet/mcc/i  nclude/si  m_x  act . 
h 


/simnet/common/include/prot 

ocol/status.h 


Table  2.21-38  EncodeVehicleStatusFAAD  Information. 


2.21.1.12.2 


DecodeVehicleStatusFAAD 


DecodeVehicleStatusFAAD  decodes  an  FAAD  VehicleSpecificStatus  structure  into  a  form 
supplied  to  the  SCC  Macintosh.  The  function  call  is  DecodeVehicleStatusFAAD(vss,  loc). 
Table  2.21-39  describes  the  parameters  usedby  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

vss 

pointer  to 

VehicleSpecificStatus 

/simnet/common/include/prot 

ocol/status.h 

loc 

SimVehicleStatus 

/simnet/mcc/include/sim  xact. 
h 

Table  2.21-39  DecodeVehicleStatusFAAD  Information. 


2.21.1.12.3 


TotalFuelFAAD 


TotalFuelFAAD  adds  up  the  fuel  aboard  an  FAAD.  fuel  gets  the  amount  of  total  fuel.  The 
function  call  is  TotalFuelFAAD(vss,  fuel).  Table  2.21-40  describes  the  parameters  usedby 
this  function. 


Parameter 


vss 


Parameters 


VehicleSpecificStatus 


inter  to  float 


Where  Typedef  Declared 


/simnet/common/include/prot 

ocol/status.h 


Standard  C  type. 


Table  2.21-40  TotalFuelFAAD  Information. 

2.21.1.13  fqueue.c 

/simnet/mcc/libmcc/fqueue  .c 

The  fqueue  module  provides  the  functionality  of  a  fast,  hash  accessed  queue  mechanism. 
The  queue  is  implemented  using  offsets  from  a  known  point  in  memory  to  accesses  hash 
and  data  buckets.  An  arbitrary  number  of  fqueue  objects  may  exist  at  any  time,  and  all  arc- 
independent  of  each  other  at  the  ADT  level.  Routines  are  provided  to  insert,  remove, 
initi^ize  or  iterate  through  a  queue.  Vehicle  Appearance  packets,  status  packets  and  a  list 
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of  activation  locations  are  currently  stored  using  fqueue  structures  since  they  must  be 
accessed  quickly  by  a  48  bit  key. 

2.21.1.13.1  Hash_Get_Entry 


Hash_Get_Entry  gets  an  entry  from  the  queue.  The  function  call  is 
Hash_Get_Entry^Queue_Head,  Key,  Hash_Bucket_Ptr,  Hash_Func).  Table  2.21-41 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

FQueue  Head 

pointer  to  FQueue  Head  t 

/si  mnet/mcc/libmcc/f  gu  eu  e .  h 

Key 

pointer  to  char 

Standard  C  type. 

Hash_Bucket_Rr 

pointer  to  pointer  to 

Hash  Entry  t 

/simnet/mcc/libmcc/fqueue.h 

iV  dll 

unsigned  int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

Bucket  Index 

unsigned  int 

Standard  C  type. 

Queue  Entry 

pointer  to  FQueue  t 

/si  mnet/mcc/libmcc/fgueu  e .  h 

Hash  Bucket 

pointer  to  Hash  Entry  t 

/simnet/mcc/libmcc/fgueue.h 

Hash  Table 

/simnet/mcc/libmcc/fgueue .  h 

i 

unsinged  int 

Standard  C  type. 

Zone 

pointer  to  char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

Queue_Entry 

pointer  to  FQueueJ 

The  specified  queue  entry. 

NULL 

pointer  to  FQueueJ 

There  is  no  queue  entry. 

1  Called  By  1 

Function 

Where  Described 

FQueue  Insert 

See  Section  2.21.1.13.4. 

FQueue  Remove 

See  Section  2.21.1.13.5. 

FQueue  Retrieve 

See  Section  2.21.1.13.7. 

Table  2.21-41  Hash_Get_Entry  Information. 
2.21.1.13.2  Alloc  Free 


Alloc_Free  is  currently  a  dummy  function  which  contains  no  code  and  always  returns  0. 
The  function  call  is  Alloc_Free(FQueue_Head).  Table  2.21-42  describes  the  parameters 
used  and  functions  called  using  this  function. 
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2.21.1.13.3 


Table  2.21-42  Alioc_Free  Information. 
FQueue_Create 


FQueue_Create  creates  an  fqueue  structure.  The  function  call  is 
FQueue_Create(FQueue_Head_Ptr,  Max_Qucue_Size,  EntTy_Size,  Alloc_Func, 
Hash_Func,  Key_Size,  Table_Size,  U_Param,  U_Param_Size).  Table  2.21-43  describes 
the  parameters  used  by  this  function. 


Parameters 

Parameter 

Where  Tvoedef  Declared 

FQueue_Head_Ptr 

pointer  to  pointer  to 

FQueue  Head  t 

/simnet/mcc/libmcc/fqueue.h 

Max  Queue  Size 

int 

Standard  C  type. 

Entry  Size 


(Alloc_Func)() 


(Hash_Func)() 


Key  Size 


Table  Size 


U  Param 


U  Param  Size 


function  that  returns  pointer  to 
int 


function  that  returns  pointer  to 
unsioned  int 


int 


int 


inter  to  char 


int 


irs 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Standard  C  type 


Standard  C  type. 


Standard  C  type 


Standard  C  type. 


Variable 


FQueue  Head 


Prev  Free  Ent 


Hash  Table 


Mem  Block 


Zone 


Head  Mem  Block 


Start  Of  Zone 


Total  Entry  Size 


Internal  Variables 


e 


ointer  to  FQueue  Head  t 


ointer  to  FQueue  t 


ointer  to  FQueue  t 


inter  to  Hash  Entry  t 


inter  to  char 


inter  to  char 


ointer  to  FQueue  Head  t 


r 

ItS 
ItS 

IS 

H 


Where  Tvoedef  Declared 


/simnet/mcc/libmcc/fqueue.h 


/simnet/mcc/libmcc/fqueue.h 


/simnet/mcc/libmcc/fqueue.h 


/si  mnet/mcc/libmcc/fqu  eue .  h 


Standard  C  type. 


Standard  C  type. 


/simnet/mcc/libmcc/fqueue.h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type 


Standard  C  type 


Return  Values 

Return  Value 

Type 

Meaning 

Total  .Memory 

int 

The  total  memory  used  by  the 
fqueue  structure. 

Table  2.21-43  FQucue  Creafe  Information. 
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2.21.1.13.4 


FQueue_Inscrt 


FQueue_Insert  inserts  an  entry  in  the  fqueue  structure.  The  function  call  is 
FQueue_Insert(Fqueue_Head,  Key,  User_Data,  Hash_Func).  Table  2.21-44  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


FQueue  Head 


User  Data 


(Hash_Func){) 


Variable 


Prev  Free  Ent 


New  Ent 


Prev  Ent 


Queue  Entr 


Next  Ent 


Hash  Bucket 


Zone 


ir 

IIS 

IIS 


ointer  to  FQueue  Head  t 


inter  to  char 


inter  to  char 


function  that  returns  pointer  to  Standard  C  type, 
unsioned  int 


Where  Tvoedef  Declared 


/simnet/mcc/libmcc/fqueue.h 


Standard  C  tvoe. 


Standard  C  t 


Internal  Variables 


Tvoe 


ointer  to  FQueue  t 


ointer  to  FQueue  t 


ointer  to  FQueue  t 


ointer  to  FQueue  t 


ointer  to  FQueue  t 


pointer  to  Hash  Entry  t 


pointer  to  char 


Where  Tvoedef  Declared 


/si  mnet/mcc/librncc/foueue .  h 


/simnet/mcc/libmcc/faueue.h 


/si  mnet/mcc/libmcc/f  aueu  e .  h 


/si  mnet/mcc/librncc/foueue .  h 


/si  mnet/mcc/librncc/foueue .  h 


/simnet/mcc/libmcc/foueue.h 


Standard  C  type. 


Return  Values 


Return  Value 


0 


-1 


1 


Type 


int 


int 


int 


Meaning 


Successful 


This  entry  is  first  in  the  list. 


Unsuccessful 


Function 


Alloc  Free 


2.21.1.13.5 


Calls 


Where  Described 


See  Section  2.21.1.13.1. 


See  Section  2.21.1.13.2. 


Table  2.21-44  FQueue_Insert  Information. 
FQueue  Remove 


FQueue_Remove  removes  an  entry  from  the  fqueue  structure.  The  function  call  is 
FQueue_Remove(FQueue_Head,  Key,  User_Data,  Flag,  Hash_Func).  Table  2.21-45 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


FQueue  Head 


(Hash_Func){) 


ointer  to  FQueue  Head  t 


inter  to  char 


inter  to  char 


unsigned  char 


function  that  returns  pointer  to  Standard  C  type, 
unsioned  int 


Where  Tvoedef  Declared 


/simnet/mcc/libmcc/fqueue.h 


Standard  C  type. 


Standard  C  t 


Standard  C  type. 
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Variable 


Prev  Ent 


Next  Ent 


Hash  Bucket 


Hash  Get  Ent 


Zone 


Internal  Variables 


e 


ointer  to  FQueue  t 


inter  to  FQueue  t 


inter  to  FQueue  t 


inter  to  Hash  Entry  t 


inter  to  FQueue  t 


inter  to  char 


lOT! 

in 
irs 
ins 
ins 
ins 
ins 


MCC  CSCI 


Where  Tvpedef  Declared 


/simnet/mcc/libmcc/faueue.h 


/simnet/nDcc/libmcc/faueue.  h 


/simnet/mcc/libmcc/fqueue.h 


/simnet/mcc/libmcc/faueue.h 


/simnet/mcc/libmcc/fqueue.h 


Standard  C  t 


Return  Values 


Return  Value 


-1 


Meanin 


Unsuccessful 


Successful 


Function 


Hash  Get  Ent 


2.21.1.13.6 


Calls 


Where  Described 


See  Section  2.21.1.13.1. 


Table  2.21-45  FQueue_Reinove  Information. 
FQueue_Scan 


FQueue_Scan  finds  the  previous  entry  in  the  fqueue  structure.  The  function  call  is 
FQueue_Scan(FQueue_Head,  Prev_Entry_Ptr).  Table  2.21-46  describes  the  parameters 
used  and  functions  called  using  this  function. 


Parameters 


Parameter 


FQueue  Head 


Prev_Entry_Ptr 


\wm 
in 


ointer  to  FQueue  Head  t 


pointer  to  pointer  to 
FQueue  t 


Where  Tvoedef  Declared 


/simnet/mcc/libmcc/fqueue.h 


/simnet/mcc/libmcc/fqueue.h 


Variable 


Prev  Ent 


Zone 


Internal  Variables 


e 


ointer  to  FQueue  t 


inter  to  char 


Where  Tvoedef  Declared 


/simnet/mcc/libmcc/fqueue.h 


Standard  C  type. 


Return  Values 

Return  Value 

Type 

Meaning 

&Zone[Prev_Entry 
->Data  Offset 

pointer  to  char 

The  previous  entry 

NULL 

pointer  to  char 

There  is  no  previous  entry 

Table  2.21-46  FQueue_Scan  Information. 
2.21.1.13.7  FQueue_Retrieve 

FQueue_Retrieve  an  entry  from  the  fqueue  structure.  The  function  call  is 
FQueue_Retrieve(FQueue_Head,  Key,  Hash_Func).  Table  2.21-47  describes  the 
parameters  used  and  functions  called  using  this  function. 
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Parameters 


Parameter 


FQueue  Head 


(Hash_Func)() 


variable 


Hash  Bucket 


Hash  Get  Ent 


Zone 


MCC  CSCI 


Where  Tvoedef  Declared 


/simnet/mcc/libmcc/fqueue.h 


Standard  C  type. 


inter  to  FQueue  Head  t 


inter  to  char 


function  that  returns  pointer  to  Staridard  C  type, 
unsianed  int 


IEI7T 

irs 
irs 
ir:: 
irs 


Internal  Variables 


e 


inter  to  FQueue  t 


inter  to  Hash  Entry  t 


inter  to  FQueue  t 


inter  to  char 


Where  Tvoedef  Declared 


/simnet/mcc/libmcc/fqueue.h 


/simnet/mcc/libmcc/fqueue.h 


/simnet/mcc/libnfK:c/fqueue.h 


StarKfard  C  type. 


Return  Value 


NULL 


&Zone[  Entry->  Data Off  set] 


Return  Values 


Type  _ 


pointer  to  char  _ 


pointer  to  char 


Meaning 


The  entry  is  NULL 


The  specified  entry. 


Function 


Hash  Get.  Ent 


Calls 


Where  Described 


See  Section  2.21.1.13.1. 


Called  B 


Function 

Where  Described 

VehiclelDToTrailer 

See  Section  2.21.1.11.4. 

ProcessSimQueryRequest 

See  Section  2.21.1.25.4. 

2.21.1.13.8 


Table  2.21-47  FQueue_Retrieve  Information. 
FQueue_Dump_Bucket 


FQueue_Dump_Bucket  is  currently  a  dummy  function.  The  function  call  is 
FQueue_Dump_Bucket(FQueue_Head,  Key).  Table  2.21-48  describes  the  parameters 
used  by  this  function. 


Parameter 


FQueue  head 


Parameters 


e  Where  Typedef  Declared 


ointer  to  FQueue  Head  t  /simnet/mcc/libmcc/fqueue.h 


inter  to  char  I  Standard  C  type. 


Variable 


Hash  Bucket 


Bucket  Index 


Internal  Variables 


ointer  to  FQueue  t 


inter  to  Hash  Entry  t 


int 


int 


int 


Where  Tvoedef  Declared 


/simnet/mcc/libmcc/fqueue.h 


/simnet/mcc/libmcc/fqueue.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Table  2.21-48  FQueue_Dump_Bucket  Information. 
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2.21.1.13.9 


FQueue_Analyze 


FQueue_Analyze  is  currently  a  dummy  function.  The  function  call  is 
FQueue_Analyze(FQueue_Head).  Table  2.21-49  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

FQueue  Head 

pointer  to  FQueue  Head  t 

/simnet/mcc/libmcc/fqueue.  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  Ctvpe. 

Depth 

array  of  100  int 

Standard  Ctype. 

Used 

int 

Standard  Ctype. 

Entries 

int 

Standard  Ctype. 

Hash  Bucket 

pointer  to  Hash  Entry  t 

/simnet/mcc/libmcc/faueue.h 

Table  2.21-49  FQueue_Analyze  Information. 

2.21.1.14  fred.c 

/simnet/mcc/libmcc/lTed.c 

Fully  Reconfigurably  Evaluation  Device  vehicles  (FRED)  have  specific  status  information 
relating  to  parameters  such  as  fuel  and  armament.  This  module  decodes  and  encodes 
FRED  status  information  for  communication  between  the  MCC  host  process  and  the  SCC 
Macintosh  console. 


2.21.1.14.1 


EncodeVehicleStatusFRED 


EncodeVehicleStatusFRED  builds  an  FRED  status  structure  in  a  GenericVehicleStatus  from 
data  supplied  by  the  SCC  or  Place  console.  The  function  call  is 

Encode VehicleStatusFRED(loc,  vss).  Table  2.21-50  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

loc 

pointer  to  SimVehicleStatus 

/simnet'mcc/include/sim  _xact. 
h 

yss 

pointer  to 

VehicleSpecificStatus 

/simnet/common/include/prot 

ocol/status.h 

Called  By 

Function 

Where  Described 

ProcessSimlnitRequest 

See  Section  2.21.1.25.2. 

Table  2.21-50  EncodeVehicleStatusFRED  Information. 
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2 . 2 1 . ! .  1 4 . 2  DecodeV  ehicleStatusFRED 


E)ecodeVehicleStatusFRED  decodes  an  FRED  VehicleSpecificStatus  structure  into  a  form 
supplied  to  the  SCC  Macintosh.  The  function  call  is  Decode  Vehicles  tatusFRED(vss,  loc). 
Table  2.21-51  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

vss 

pointer  to 

VehicleSpecificStatus 

/simnet/common/include/prot 
ocol/status  h 

loc 

pointer  to  SimVehicleStatus 

/simnet/mcc/include/sim  xact. 
h 

Called  By 

Function 

Where  Described 

ProcessSimQueryRequest 

See  Section  2.21.1.25.4. 

Table  2.21-51  DecodeVehicleStatusFRED  Information. 


2.21.1.14.3  fred_encode_fallures 

fred_encode_failures  fills  in  the  error  bits  of  the  failures.  The  function  call  is 
fTed_encode_failures(vehicle_status).  Table  2.21-52  describes  the  parameters  used  by  this 
function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

vehicle_status 

pointer  to  VehicleStatus 

/simnet/common/include/prot 
ocol/status.  h 

Calls 

Function 

Where  Described 

veh_subsys_encode_air_failu 

res 

See  Sectic.i  2.21.1.30.3. 

Called  By 

Function 

Where  Described 

ProcessSimlnitRequest 

See  Section  2.21.1.25.2. 

Table  2.21-52  fred_encode_failures  Information. 

2.21.1.15  generic.c 

/simnet/mcc/libmcc/generic.c 

generic.c  contains  routines  for  handling  generic  vehicles.  Currently,  the  only  information 
handled  is  fuel. 


2. 21. 1. 15.1 


TotalFuelGeneric 


TotalFuelGeneric  adds  up  the  fuel  aboard  a  Generic  vehicle,  fuel  gets  the  amount  of  total 
fuel.  The  function  call  is  TotalFuelGenericfvss,  fuel).  Table  2.21-53  describes  the 
parameters  usedby  this  function. 
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_ Parameters _ 

Parameter _ Type _ Where  Typedef  Declared 

vss  VehicleSpecificStatus  /simnet/common/include/prot 

_ ocol/status.h _ 

fuel_ pointer  to  float_ Standard  C  type. 


Called  B 


Function 

Where  Described 

TotalVehicleFuel 

See  Section  2.21.1.28.1. 

Table  2.2L-53  TotalFuelGeneric  Information. 

2.21.1.16  grid.c 

/sininet/mcc/libmcc/grid.c 

Internally,  the  MCC  uses  Cartesian  coordinates  to  coordinate  activity  of  its  asset  vehicles  as 
they  exist  on  the  terrain.  The  Macintosh  user  interface  consoles  display  and  accept 
coordinate  information  in  Universal  Transverse  Mercator  format,  grid.c  provides  for 
loading  information  from  the  terrain  database  onto  the  Macintosh  consoles  in  the  correct 
format. 

2.21.1.16.1  ProcessGri  dInfoRequest 


ProcessGridInfoRequest  processes  a  request  for  Gridinfo  from  a  Mac.  The  function  call  is 
ProcessGridlnfoRequest(t).  Table  2.21-54  describes  the  parameters  used,  internal 
variables  used,  and  return  values  generated  by  using  this  function. 


1  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

I 

pointer  to  Transaction 

/simnet/mcc/include^bridae.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

pointer  to  char 

Standard  C  type. 

rsp 

register  pointer  to  GridZone 

/si  mnet/co  mmon/li  bs  rc/libtdb/ 
map.h 

Return  Values 

Return  Value 

Type 

Meaning 

1 

int 

successful 

0 

int 

operation  failed,  errno  set  to 
indicate  error 

Calls 

Function 

Where  Described 

ATPRequesfData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResponse 

See  Section  2.21.1.7.6. 

Table  2.21-54  ProcessGridInfoRequest  Information. 
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2.21.1.17  guise. c 

/simnet/mcc/libmcc/guise.c 

Vehicles  on  the  battlefield  can  have  several  discrete  pairs  of  guises  depending  upon  the 
force  the  simulating  entity  belongs  to.  guise.c  provides  the  mapping  from  a  specific  vehicle 
type  simulated  or  activated  from  an  MCC  to  the  pair  of  guises  appropriate  to  Aat  vehicle. 
For  a  more  complete  discussion  of  guise  semantics,  refer  to  the  document,  "The  SIMNET 
Network  and  Protocols,"  July,  1989.  TAble  2.21-55  describes  the  variables  used  by 
guise.c. 


Variables 


Variable 


guiseTable{NUM_OBJECT_G  matrix  of  ObjectType 
ROUPSIfNUM  COUNTRIESl 


Where  Tvpedef  Declared 


/simnet/common/include/prot 

ocol/basic.h 


2.21.1.17.1 


Table  2.21-55  guise.c  Variable  Information. 
GetGuises 


GetGuises  fills  in  the  guises  appropriate  to  the  input  parameters.  The  function  call  is 
GetGuises(battleScheme,  forcelD,  objType,  guises).  Table  2.21-56  describes  the 
parameters  used,  internal  variables  used,  and  return  values  generated  by  using  this 
function. 


Parameters 


Parameter 


battleScheme 


forcelD 


objType 


guises 


1 1173 


e 


int 


ForcelD 


ObjectType 


pointer  to  VehicleGuises 


Where  Typedef  Declared 


Standard  C  type. 


/simnet/common/include/prot 

ocol/basic.h 


/simnet/common/include/prot 

ocol/basic.h 


/simnet/common/include/prot 

ocol/basic.h 


Variable 


scheme 


Internal  Variables 


e 


inter  to  BattleSchemes 


distConirvIndex 


otherCountrylndex 


Where  Typedef  Declared 


/simnet/mcc/libmcc/quise.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Return  Values 


Return  Value 


-1 


Type 


int 


int 


Meaning 


Invalid  forcelD  or  objT 


Successful;  guises  filled  in. 


Called  B 


Function 

Where  Described 

ProcessSimlnitRequest 

See  Section  2.21.1.25.2. 

Table  2.21-56  GetGuises  Information. 
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2.21.1.18  hash.c 

/simnel/mcc/libmcc/hash.c 

The  hashing  functions  used  by  the  MCC  to  hash  the  48  bit  keys  used  in  various  fqueue 
objects  are  defined  here.  The  hash  functions  all  return  hash  table  bucket  indexes  when 
given  a  key  to  hash. 

2.21.1.18.1  vList_Hash 

vList_Hash  returns  a  hash  table  bucket  index  for  the  vehicle  list  fqueue.  The  function  call 
is  vList_Hash(key,  Param).  Table  2.21-57  describes  the  parameters  used,  internal 
variables  used,  and  return  values  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

key 

register  pointer  to  unsigned 
short 

Standard  C  type. 

Param 

register  pointer  to 
MCCParameters 

/simnet/mcc/include/MCC_par 

s.h 

1  internal  Variables  I 

Variable 

Where  Typedef  Declared 

index 

register  unsigned  long 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

index 

1  TTiini'iiiii  I'll  rii'ri’r— 

Hash  table  bucket  index 

Table  2.21-57  vList  Hash  Information. 


2.21.1.18.2  vStatusList_Hash 

vStatusList_Hash  returns  a  hash  table  bucket  index  for  the  vehicle  status  list  fqueue.  The 
function  call  is  vStatusList_Hash(key,  Param).  Table  2.21-58  describes  the  parameters 
used,  internal  variables  used,  and  return  values  generated  by  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

key 

register  pointer  to  unsigned 
short 

Standard  C  type 

Param 

register  pointer  to 
MCCParameters 

/si  mnet/mcc/i  nclude/M  CCjoar 
s.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

index 

register  unsigned  long 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

index 

register  unsigned  long 

Hash  table  bucket  index 

Table  2.21-58  vStatusList  Hash  Information. 
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2.21.1.19  init.c 

/simnet/mcc/libnKcAnit.c 

All  MCC  processes  initialize  or  attach  to  sections  of  shared  memory  and  critical  regions 
when  they  are  first  activated.  The  processes  are  all  synchronized  and  initial 
communications  are  set  up.  init.c  controls  the  initialization  sequence.  Table  2.21-59 
describes  the  variables  us^  by  init.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

proqname 

pointer  to  char 

Standard  C  type. 

Table  2.21>59  init.c  Variable  Information. 


2.21.1.19.1  InitializeProcess 

InitializeProcess  initializes  the  standard  MCC  process  enviroment.  The  function  call  is 
InitializeProcess(processNumber,  processName,  handler,  topLevel).  Table  2.21-60 
describes  the  parameters  used,  internal  variables  used,  and  return  v^ues  generated  by  using 
this  function. 


Parameters 


Parameter 


rocessNumber 


rocessName 


handler 


tooLevel 


Variable 


Function 


InitErrorHandlin 


OoenNetworklnterface 


AttachLocks 


AttachSharedMem 


YUMMInit 


YUMMProcess 


OpenSocket 


InttAlarms 


inter  to  char 


pointer  to  function  returning 
int 


int 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Standard  C  t 


Internal  Variables 


e 


reoister  short 


IB71 


Where  Tvoedef  Declared 


Standard  C  type. 


Calls 


Where  Described 


See  Section  2.21.1.11.1. 


See  Section  2.21.1.22.3. 


See  Section  2.21.2.6.1. 


See  Section  2.21.2.7.1. 


See  Section  2.21.2.10.1. 


See  Section  2.21.2.10.2. 


See  Section  2.21.2.10.3. 


See  Section  2.21.2.4.1. 


Table  2.21-60  InitializeProcess  Information. 
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2.21.1.19.2  TraceHandler 

TraceHandler  is  the  front-end  to  TraceMessage  for  registering  with  YUMM.  The  function 
call  is  TraceHandler(type,  tid,  dstSkt,  rspSkt,  kind,  length,  data).  Table  2.21-61  describes 
the  parameters  used  and  functions  us^  by  this  function. 


1  Parameters  I 

1  Parameter 

Type 

Where  Tvpedef  Declared 

char 

Standard  C  type. 

tid 

char 

Standard  C  type. 

dstSkt 

YUMMSocket 

/simnet/rcs/libipc/yumm.h 

rspSkt 

YUMMSocket 

/si  mnet/rcs/libi  pc/y  umm .  h 

kind 

Iona 

Standard  C  type. 

lenath 

int 

Standard  C  type. 

data 

pointer  to  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

TraceMessaqe 

See  Section  2.21.1.19.3. 

Table  2.21-61  TraceHandler  Information. 
2.21.1.19.3  TraceMessage 


TraceMessage  prints  a  message  received  by  an  MCC  process.  The  function  call  is 
TraceMessage(kind,  msg).  Table  2.21-62  describes  the  parameters  used  by  this  function. 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

kind 

lonq 

Standard  C  type. 

msg 

register  pointer  to 
MCCMessaqeBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

I  Called  By  I 

Function 

Where  Described 

ATReceive 

See  Section  2.21.1.1.7. 

NBPReceive 

See  Section  2.21.1.3.2, 

TraceHandler 

See  Section  2.21.1.19.2. 

ProcessSimlnitRequest 

See  Section  2.21.1.25.2. 

Table  2.21-62  TraceMessage  Information. 
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2.21.1.19.4 


InitUnit 


InitUnit  initializes  information  for  a  unit.  The  function  call  is  InitUnit(unit  forcelD,  type, 
army,  corps,  division,  brigade,  battalion,  company,  platoon,  section,  squad).  Table 
2.21-63  describes  the  parameters  used  by  this  function. 


Parameters 


Parameter 


Type 


Where  Typedef  Declared 


unit 


pointer  to  OrganizationalUnit 


/simnet/common/include/prot 
ocol/basic.h 


forcelD 


int 


Standard  C  type- 


type 


unsigned  char 


Standard  C  type. 


army 


int 


Standard  C  type- 


corps 


int 


Standard  C  type. 


division 


int 


Standard  C  type. 


brigade 


int 


Standard  C  type. 


battalion 


int 


Standard  C  type. 


company 


int 


Standard  C  type- 


platoon 


int 


Standard  C  type. 


section 


int 


Standard  C  type. 


sguad 


int 


Standard  C  type. 


Called  By 


Function 


Where  Described 


ProcessSimlnitReguest 


See  Section  2.21.1.25.2. 


Table  2.21-63  InitUnit  Information. 


2.21.1.20  ml.c 

/simnet/mcc/libmcc/m  1  .c 

Ml  tanks  have  specific  status  information  relating  to  parameters  such  as  fuel  and  armament, 
ml.c  decodes  and  encodes  Ml  status  information  for  communication  between  the  MCC 
host  process  and  the  SCC  Macintosh  console. 

2.21.1.20.1  Encode  VehicleStatusMl 


EncodeVehicleStatusMl  builds  an  Ml  VehicleSpcificStatus  structure  from  data  supplied  by 
the  SCC  or  Place  console.  The  function  call  is  EncodeVehicleStatusMl(loc,  vss).  Table 
2.21-64  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

loc 

pointer  to  SimVehicleStatus 

/simnet/mcc/include/sim  xact. 
h 

vss 

pointer  to 

Ve  h  icIeSpecificStatus 

/simnet/common/include/prot 

ocol/status.h 

1  Called  By  I 

Function 

Where  Described 

ProcessSimlnitReguest 

See  Section  2.21.1.25.2. 

Table  2.21-64  EncodeVehicleStatusMl  Information. 
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2.21.1.20.2 


Decode  VehicleStatusM  1 


Decode VehicleStatusMl  decodes  an  Ml  VehicleSpecificStatus  structure  into  a  form 
supplied  to  the  SCC  Macintosh.  The  function  call  is  DecodeVehicleStatusMl(vss,  loc). 
Table  2.21-65  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

vss 

pointer  to 

VehicleSpecificStatus 

/simnet/common/include/prot 

ocol/status.h 

loc 

pointer  to  SimVehicieStatus 

/simnet/mcc/include/sim  xact. 
h 

Called  Bv 

Function 

Where  Described 

ProcessSimQuervRequest 

See  Section  2.21.1.25.4. 

Table  2.21-65  DecodeVehicleStatusMl  Information. 


2.21.1.20.3  TotalFuelMl 


TotalFuelMl  adds  up  the  fuel  aboard  an  Ml.  fuel  gets  the  amount  of  total  fuel.  The 
function  call  is  TotalFuelMl (vss,  fuel).  Table  2.21-66  describes  the  parameters  used  by 
this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

vss 

pointer  to 

VehicleSpecificStatus 

/simnet/common/include/prot 

ocol/status.h 

fuel 

pointer  to  float 

Standard  C  type. 

Called  By 

Function 

Where  Described 

TotalVehicleFuel 

See  Section  2.21.1.28.1. 

Table  2.21-66  TotalFuelMl  Information. 


2.21.1.20.4  ml  encode  failures 


ml_encode_failures  fills  in  the  error  bits  for  the  failures.  The  function  call  is 
ml_encode_failures(vehicle_status).  Table  2.21-67  describes  the  parameters  used  by  this 
function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

vehicle_status 

pointer  to  VehicleStatus 

/simnet/common/include/prot 

ocol/status.h 

1  Calls  1 

Function 

Where  Described 

ve  h_sub  sy  s_e  ncode_g  rou  nd 
failures 

See  Section  2.21.1.30.2. 
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Called  B 


Function 

Where  Described 

ProcessSimlnitRequest 

See  Section  2.21.1.25.2. 

Table  2.21-67  inl_encode_failures  Information. 

2.21.1.21  m2.c 

/simnet/mcc/libmcc/m2.c 

M2/M3  APCs  have  specific  status  information  relating  to  parameters  such  as  fuel  and 
armament  m2.c  decodes  and  encodes  M2/M3  status  information  for  communication 
between  the  MCC  host  process  and  the  SCC  Macintosh  console. 

2.21.1.21.1  Encode  Veh  icleStatusM2 

EncodeVehicleStatusM2  builds  an  M2  VehicleSpcificStatus  structure  from  data  supplied  by 
the  SCC  or  Place  console.  The  function  call  is  EncodeVehicleStatusM2(loc,  vss).  Table 
2.21-68  describes  the  parameters  used  by  this  function. 

Parameters 

Parameter  Type  Where  Typedef  Declared 

loc  pointer  to  SimVehicleStatus  /simnet/mcc/jnclude/sim_xact. 

_ _h _ 

vss  pointer  to  /simnet/common/include/prot 

VehicleSpecificStatus_ ocol/status.h 


Called  B 


Function 

Where  Described 

ProcessSimlnitRequest 

See  Section  2.21.1.25.2. 

Table  2.21-68  EncodeVehicleStatusFAAD  Information. 


2.21.1.21.2  Decode  VehicIeStatusM2 

DecodeVehicleStatusM2  decodes  an  M2  VehicleSpecificStatus  structure  into  a  form 
supplied  to  the  SCC  Macintosh.  The  function  call  is  DecodeVehicleStatusM2(vss,  loc). 
Table  2.21-69  describes  the  parameters  used  by  this  function. 

_ _ Parameters _ 

Parameter _  Type  I  Where  Typedef  Declared 

vss  pointer  to  /simnet/common/include/prot 

_ VehicleSpecificStatus _ ocol/status.h _ 

loc  pointer  to  SimVehicleStatus  /simnet/mcc/include/sim_xact. 

 h 


_ _ Called  By _ 

Function _ Where  Described _ 

ProcessSimQueryRequest  See  Section  2.21  ■1.25.4. 

Table  2.21-69  DecodeVehicleStatusM2  Information. 
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2.21.1.21.3 


TotalFueiM2 


TotalFuelM2  adds  up  the  fuel  aboard  an  M2,  fuel  gets  the  amount  of  total  fuel.  The 
function  call  is  TotalFuelM2(vss,  fuel).  Table  2.21-70  describes  the  parameters  used  by 
this  function. 


Parameter 


vss 


Parameters 


e 


pointer  to 

VehicleSoedficStatus 


inter  to  float 


on 

i 

IS 


Where  Tvoedef  Declared 


/simnet/common/include/prot 

ocol/status.h 


Standard  C  t 


Called  B 


Function 

Where  Described 

TotalVehicleFuel 

See  Section  2.21.1.28.1. 

2.21.1.21.4 


Table  2.21-70  TotalFuelM2  Information. 
m2  encode  failures 


m2_encode_failures  fills  in  the  error  bits  for  the  failures.  The  function  call  is 
m2_encode_failures(vehicle_status).  Table  2.21-71  describes  the  parameters  used  by  this 
function. 


Parameters 


Parameter 


vehicle_status 


IDT! 


pointer  to  VehicleStatus 


Where  Tvoedef  Declared 


/simnet/common/include/prot 

ocol/status.h 


Calls 


Function  Where  Described 


veh_subsys_encode_ground  See  Section  2.21.1.30.2. 
failures 


Called  B 


Function 

Where  Described 

ProcessSim  1  nit  Request 

See  Section  2.21.1.25.2. 

Table  2.21-71  m2  encode  failures  Information. 
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2.21.1.22  net.c 

/simnet/mcci^bmcc/net.c 

Each  MCC  host  process  must  obtain  a  data  pathway  to  the  network  adapter  unit  upon 
initialization.  Upon  successful  termination,  each  process  relinquishes  the  resources  used 
by  the  data  path.  net.c  provides  routines  to  open  and  close  the  ^ta  path.  Table  2.21-72 
describes  the  variables  used  by  net.c. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

q  ethernet  two  packets 

int 

Standard  C  type. 

hdr 

NetworkHeader 

/simnet/libsrc/libnetif/network. 

h 

networkinterface 

int 

Standard  C  type. 

Table  2.21-72  net.c  Variable  Information. 


2.21.1.22.1  SAP  NET  SND  KLUDGE 


SAF_NET_SND_KLUDGE  allows  the  MCC  to  send  out  either  Ethernet  2.0  or  Ethernet 
802.3  packets.  The  function  call  is  SAF_NET_SND_KLUDGE(h,  to,  buf,  len,  flags). 
Table  2.21-73  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

h 

int 

Standard  C  type. 

to 

pointer  to  NetworkAddress 

/simnet/libsrc/libnetif/network. 

h 

buf 

pointer  to  char 

Standard  C  type. 

len 

int 

Standard  C  type. 

flags 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

net_snd(h,  to,  buf,  len,  flags) 

int 

send  Ethernet  2.0  packets. 

net_send{h,  &hdr,  buf,  len, 
flags) 

int 

send  Ethernet  802.3  packets. 

Calls 

Function 

Where  Described 

net  snd 

See  Section  2.20.2.19.2. 

net  send 

See  Section  2.20.2.15.1. 

Table  2.21-73  SAF_NET_SND_KLUDGE  Information. 
2.21.1.22.2  set_g_ethernet_two_packets 


set_g_ethemet_two_packets  set  g  ethernet  two  jyackets  to  TRUE.  The  function  call  is 
set_g_ethemet_two_packets().  This  function  calls  only  standard  functions  and  is  not  called 
by  any  other  function  in  this  library,  so  no  table  is  included  for  it. 
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2.21.1.22.3  OpenNetworkInterface 

OpenNetworidnterface  obtains  access  to  the  simulation  Ethernet  The  function  call  is 
C^nNetworkInterface(topLevel).  Table  2.21-74  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

topLevel 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

AssocOoen 

See  Section  2.20.1.5.1. 

MCC_  SystemError 

See  Section  2.21.1.11.3. 

AssocError 

See  Section  2.20.1.10.1. 

AssocAttach 

See  Section  2.20.1.5.2. 

1  Called  By  I 

Function 

Where  Described 

initiafizeProcess 

See  Section  2.21.1.19.1. 

Table  2.21-74  OpenNetworkInterface  Information. 

2.21.1.22.4  CloseNetworkInterface 

CloseNetworkInterface  releases  access  to  the  simulation  Ethernet.  The  function  call  is 
CloseNetworkInterfaceO.  Table  2.21-75  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

net  close 

See  Section  2.20.2.3.1. 

Table  2.21-75  CloseNetworkInterface  Information. 

2.21.1.23  radio.c 

/simnet/mcc/libmcc/radio.c 

Radio  power  control  to  MCC  controlled  TOC  radios  is  controlled  through  this  module. 
Radios  are  currently  not  controlled  by  fielded  MCC  systems. 


2.21.1.23.1 


InitRadios 


InitRadios  initializes  all  radios  to  “off*.  The  function  call  is  InitRadiosQ.  Table  2.21-76 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

bitmask 

array  of  9  char 

Standard  C  type. 

temp 

register  short 

Standard  C  type. 

i 

register  short 

Standard  C  type. 

L  1 
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1  Calls  1 

Function 

Where  Described 

bbd  init 

See  Section  2.1.5.1.11.1  in  the  Vehicles  CSCI. 

Table  2.21-76  InitRadios  Information. 


2.21.1.23.2  RemoveRadios 


RemoveRadios  uninitializes  the  radio  power  control.  The  function  call  is  RemoveRadios(). 
Table  2.21-77  describes  the  functions  called  using  this  function. 


I  Calls  I 

Function 

Where  Described 

bbd  uninit 

See  Section  2.1.5.1.16.1  in  the  Vehicles  CSCI. 

Table  2.21-77  RemoveRadios  Information. 


2.21.1.23.3  TurnRadioOn 


TumRadioOn  turns  on  rarfio.  The  function  call  is  TumRadioOn(radio).  Table  2.21-78 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

radio 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

bbd  bit  out 

See  Section  2.1. 5.1. 4.1  in  the  Vehicles  CSCI. 

Table  2.21-78  TurnRadioOn  Information. 


2.21.1.23.4  TurnRadioOff 


TumRadioOff  turns  off  radio.  The  function  call  is  TumRadioOff(radio).  Table  2.21-79 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Tvoe 

Where  Typedef  Declared 

radio 

short 

Standard  C  type. 

Calls 

Function 

Where  Described 

bbd  bit  out 

See  Section  2.1. 5. 1.4.1  in  the  Vehicles  CSCI. 

Table  2.21-79  TurnRadioOff  Information. 
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2.21.1.24  segintr.c 

/simnet/mcc/libmcc/segintr.c 

segintr.c  contains  functions  which  determine  if  a  line  segrnent  crosses  or  touches 
inappropriately  (i.e.  in  the  middle)  any  of  an  array  of  previous  line  segments. 

2.21.1.24.1  seg_intrsct 

seg^intrsct  computes  information  on  the  intersection  of  a  line  segment  from  pt  Op  topt  lp 
with  the  (connected)  line  segments  pt_arr[0]  lopt  arrlnum _p£s  - 1].  It  requires  that 
num _pts  is  greater  than  2.  For  computing  points  of  intersection,  paramsp->size_out _ptsp 
should  be  at  least  2  (or  1  more  than  you  expect),  in  case  of  segment  overlap.  The  function 
call  is  seg_intrsct(paramsp).  Table  2.21-80  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

paramsp 

pointer  to  seointparams 

/simnet/mcc/libmcc/seqintr.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

use  X 

reaister  int 

Standard  C  type. 

X  diff 

reoister  int 

Standard  C  type. 

V  diff 

reqister  int 

Standard  C  type. 

i 

reqister  int 

Standard  C  type. 

slope 

reaister  double 

Standard  C  type. 

code 

reqister  int 

Standard  C  type. 

abort  code 

reqister  int 

Standard  C  type. 

nu.n  code 

reqister  int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

code 

int 

The  segment  intersection 
code  describing  the  type  of 
intersection. 

DUMflY 

int 

Not  a  yalid  segment. 

1  Calls  1 

Function 

Where  Described 

check  X  infs 

See  Section  2.21.1.24.2. 

reverse  param 

See  Section  2.21.1.24.4. 

See  Section  2.21.1.24.3. 

Table  2.21>80  seg^intrsct  Information. 

2.21.1.24.2  check_x_ints 

check_x_ints  checks  for  an  intersection  of  the  finite  line  segments;  ptp  to  pt  Op  (u  ith  slope 
(dy/dx)  assumed  between  -1  and  1)  and  pt  lp  \opi_2p.  The  function  call  is 
check_x_ints(ptOp,  ptlp,  slope,  pt2p,  pt3p,  outcode,  outp,  outp2,  numoutp).  Tabic 
2.21-81  describes  the  parameters  used  and  functions  called  using  this  function. 
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Parameter 


0Ut2 


numout 


Variable 


e 


inter 


inter 


double 


inter 


inter 


int 


inter 


ointer 


inter 


Parameters 


to  Lona  Point 


to  Lono  Point 


to  Lonq  Point 


to  Lono  Point 


to  coded  iDoint 


to  coded  Ipoint 


to  int 


rioht 


1  left 


1  riant 


distt 


dist2 


delta  X 


slope2 


Internal  Variables 


e 


inter  to  Lono  Poin  t 


ointer  to  Lona  Point 


ointer  to  Lona  Point 


ointer  to  Lonq  Point 


double 


double 


double 


double 


MCC  CSCI 


Where  Typedef  Declared 


/simnet/mcc/libmcc/seqintr.h 


/simnet/mcc/libmcc/seomtr.h 


Standard  C  t 


/simnet/mcc/libmcc/seqintr.h 


/simnet/mcc/libmcc/seqi  ntr.  h 


Standard  C  t 


/si  mnet/mcc/libmcc/seqi  ntr.  h 


/si  mnet/mcc/libmcc/segintr.  h 


Standard  C  t 


Where  Tvoedef  Declared 


/si  mnet/mcc/libmcc/seqi  ntr.  h 


/simnet/mcc/libmcc/seqinfr.h 


/si  mnet/mcc/li  bmcc/seai  nt  r.  h 


/simnet/mcc/libmcc/seqintr.h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Return  Values 


Return  Value 


ON  ONE  SIDE 


Type 


int 


BOTH  ON  LINE  ABUTTING  I  int 


BOTH_ON_LINE_OVERLAP  int 
PING 


ON  LINE  TO  SIDE  int 


ON_LINE  ABUTTING 


ON_LINE_MID_TOUCH 


MID_CROSS 


ABUTTING 


Meanin 


The  segments  miss; 
separated  by  x  or 


The  giyen  segment  is  colinear 
to  another  and  the  vertices 
touch. 


The  segments  are  colinear 
and  the  vertices  do  not  touch 


A  vertex  is  on  an  extended 
line,  but  not  on  the  segment; 
there  is  no  intersection. 


One  pair  of  vertices  touch 


One  vertex  touches  the 
middle  of  the  qiven  semqnet 


The  line  segments  cross  in  the 
middle. 


The  given  segment  is  abutted 
by  the  other. 


Calls 

Function 

Where  Described 

POINT  TO  LINE 

Macro  defined  in  /simnet/rrxjc/libmcc/seqintr.h. 

Function 


sea  intrsct 


Called  B 


Where  Described 


See  Section  2.21.1.24.1. 


Table  2.21-81  check  x  ints  Information. 
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.21.1.24.3 


check_y_ints 


check_y_ints  checks  for  an  intersection  of  the  finite  line  segments:  ptp  to  pt  Op  (with  slope 
(dy/dx)  assumed  between  -1  and  1)  and  pt_lp  iopt_2p.  The  function  call  is 
check_y_ints(ptOp,  ptlp,  slope,  pt2p,  pt3p,  outcode,  outp,  outp2,  numoutp).  Table 
2.21-82  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


out2 


numout 


Variable 


distl 


dist2 


delta  X 


sloDe2 


e 


inter 


inter 


double 


inter 


inter 


int 


ointer 


ointer 


inter 


Parameters 


to  Lono  Point 


to  Lono  Point 


to  Lono  Point 


to  Lono  Point 


to  coded  iDOint 


to  coded  iDOint 


to  int 


Internal  Variables 


e 


inter  to  Lono  Poin  t 


ointer  to  Lono  Point 


ointer  to  Lono  Point 


ointer  to  Lono  Point 


double 


double 


double 


double 


Where  Tvoedef  Declared 


/si  mnet/mcc/libmcc/segi  ntr.  h 


/simnet/mcc/libmcc/seointr.h 


Standard  C  t 


/si  mnet/mcc/librncc/seoi  ntr.  h 


/si  mnet/mcc/libmcc/seqi  ntr.  h 


Standard  C  t 


/simnet/mcc/libmcc/seqintr.h 


/si  mnet/mcc/li  bmcc/seqi  nt  r .  h 


Standard  C  type. 


Where  Tvpedef  Declared 


/si  mnet/mcc/libmcc/seqi  ntr.  h 


/simnet/mcc/libmcc/seqintr.h 


/si  mnet/mcc/libmcc/seqi ntr.  h 


/simnet/mcc/libmcc/seqintr.h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  Ivoe. 


Return  Values 

Return  Value 

Type 

Meaning 

ON_ONE_SIDE 

int 

The  segments  miss; 
separated  by  x  or  y. 

BOTH_ON_L(NE_ABUTTING 

int 

The  given  segment  is  colinear 
to  another  and  the  vertices 
touch. 

BOTH  ON  LINE  OVERLAP 
PING 

int 

The  segments  are  colinear 
and  the  vertices  do  not  touch 

ON_LINE_TO_SIDE 

int 

A  vertex  is  on  an  extended 
line,  but  not  on  the  segment; 
there  is  no  intersection. 

ON_LINE_ABUTTING 

int 

One  pair  ol  vertices  touch 

ON_LlNE_MID_TOUCH 

int 

One  vertex  touches  the 
middle  of  the  given  semqnet 

MID_CROSS 

int 

The  line  segments  cross  in  the 
middle 

ABUTTING 

int 

The  given  segment  is  abutted 
by  the  other 
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1  Calls  1 

Function 

Where  Described 

POINT  TO  LINE 

Macro  defined  in  /simnet/mcc/libmcc/seqintr.h. 

Called  By 

Function 

Where  Described 

seq  intrsct 

See  Section  2.21.1.24.1. 

Table  2.21*82  check_y_ints  Information. 


2.21.1.24.4  reverse_param 

reverse_param  reverses  the  x  and  y  coordinates  for  all  member  points  in  the  paramp 
parameter.  Member  points  include  ptOp,  ptip,  the  points  in  the  ptjirr  array,  and  the  points 
in  the  oMipttp  array.  The  function  call  is  reverse_param(paramp).  Table  2.21-83 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


Where  Tvoedef  Declared 


/simnet/mcc/libmcc/seqinlr.h 


Variable 


Internal  Variables 


e 


reqisler  int 


IBl!! 


Where  Typedef  Declared 


Standard  C  type. 


Function 


REVERSE  COORDS 


Calls 


Where  Described 


Macro  defined  in  /simnet/mcc/libmcc/seqintr.h. 


Called  B 


Function 

Where  Described 

seq  intrsct 

See  Section  2.21.1.24.1. 

Table  2.21-83  reverse_param  Information. 

2.21.1.25  sim.c 

/simnet/mcc/libmcc/sim.c 


sim.c  contains  code  used  by  the  SCC  and  Placement  console  processes  for  placing 
simulators.  It  provides  the  following  functions: 

•  information  about  simulators  available  for  the  exercise; 

•  requests  to  place  or  reconstitute  a  simulator's  vehicle; 

•  handles  requests  for  the  status  of  a  vehicle  to  be  reconstituted;  and 

•  notifies  consoles  when  a  requested  activation  has  failed. 
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2.21.1.25.1 


.  ProcessSimExistsRequest 


ProcessSimExistsRequest  processes  a  request  for  simulator  data  from  a  Mac.  The  function 
call  is  ProcessSimExistsRequest(t).  Table  2.21-84  describes  the  parameters  used,  internal 
variables  used,  and  functions  call^  by  using  this  function. 


Parameters 


Parameter 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe  .h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

req 

pointer  to  SimExistsRequest 

/si  mnet/mcc/include/si  m_xact . 
h 

rsp 

register  pointer  to 
SimExistsResponse 

/simnet/mcc/include/sim  xact. 
h 

Sim 

register  pointer  to 
SimulatorStatus 

/simnet/mcc/include/vehjabi 

e.h 

1  Calls  1 

Function 

Where  Described 

ATPReauestData 

Macro  defined  in  /simnetymcc/include/bridae.h. 

SendConsoleResponse 

See  Section  2.21.1.7.6. 

. . . . . 

See  Section  2.21.1.25.6. 

Table  2.21-84  ProcessSimExistsRequest  Information. 


2.21.1.25.2  ProcessSimlnitRequest 

ProcessSimlnitRequest  processes  a  request  to  place  a  vehicle  from  a  Mac.  vehiclePtr  is  set 
to  the  number  of  the  vehicle  activated.  The  function  call  is  ProcessSimInitRequest(t, 
vehiclePtr).  Table  2.2-85  describes  the  parameters  used,  internal  variables  used,  and 
functions  called  by  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridge.h 

vehiclePtr 

pointer  to  int 

Standard  C  type. 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

req 

register  pointer  to 
SimlnitReauest 

/simnet/mcc/include/sim_xact. 

h 

rsp 

pointer  to  SimlnitResponse 

/simnet/mcc/include/sim  xact. 
h 

vehicle 

unsigned  short 

Standard  C  type. 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
h 

rspKind 

long 

Standard  C  type 

errCode 

int 

Standard  C  type. 

rspLen 

int 

Standard  C  type. 

Sim 

register  pointer  to 
SimulatorStatus 

/simnet/mcc/include/veh  tabl 
e.h 
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1  Return  Values  1 

Return  Value 

Meaning 

1 

int 

Successful 

0 

int 

Unsuccessful 

I  Calls  I 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridae.h. 

InitUnit 

See  Section  2.21.1.19.4. 

GetGuises 

See  Section  2.21.1.17.1. 

Encode  VehicleStatusM  1 

See  Section  2.21.1.20.1. 

m1  encode  failures 

See  Section  2.21.1.20.4. 

EncodeVehicleStatusM2 

See  Section  2.21.1.21.1. 

m2  encode  failures 

See  Section  2.21.1.21.4. 

EncodeVehicleStatusFRED 

See  Section  2.21.1.14.1. 

fred  encode  failures 

See  Section  2.21.1.14.3. 

Transact 

See  Section  2.21.2.10.9. 

TraceMessaae 

See  Section  2.21.1.19.3. 

SendConsoleResponse 

See  Section  2.21.1.7.6. 

Table  2.21-85  ProcessSimlnitRequest  Information. 


2.21.1.25.3  SimGetSimType 


SimGetSimType  translates  a  vehicle  object  code  into  a  SIMNET  simulator  type.  The 
function  call  is  SimGetSimType(vehicle_object_type).  Table  2.21-86  describes  the 
parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

vehicle_object_type 

ObjectType 

/simnet/common/include/prot 

ocol/basic.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

simulator_SIMNET_M1 

SimulatorType 

The  sinujlator  is  an  M1 . 

simulator_SIMNET_M2 

SimulatorType 

The  simulator  is  an  M2. 

simulator_SIMNET_FRED 

SimulatorType 

The  simulator  is  a  FRED. 

0 

SimulatorType 

Unknown  simulator  type. 

I  Called  Bv  I 

Function 

Where  Described 

ProcessSimOueryRequest 

See  Section  2.21.1.25.4. 

Table  2.21-86  SimGetSimType  Information. 
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2.21.1.25.4  ProcessS  imQ  ueryRequest 


ProcessSimQueryRequest  responds  to  a  request  fiom  a  Macintosh  for  the  current  status  of 
a  vehicle  simulator.  The  function  call  is  ProcessSimQueryRequest(t).  Table  2.21-87 
describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridge.h 

Internal  Variables 

Variable 

Tvoe 

Where  Tvpedef  Declared 

req 

pointer  to  SimQueryRequest 

/simnet/mcc/include/sim  xact. 
h 

rsp 

pointer  to 

SimQueryResponse 

/simnet/mcc/include/sim  xact. 
h 

Sim 

pointer  to  SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

veh 

pointer  to  VehiclelDStatus 

/simnet/mcc/include/veh_tabl 

e.h 

veh_status 

pointer  to  VehicleStatus 

/simnet/common/include/prot 

ocol/status.h 

turret  Azimuth 

Angle 

/simnet/common/include/prot 

ocol/basic.h 

vehicleTvoe 

unsigned  short 

Standard  C  type. 

rollPitchYaw 

array  of  3  float 

Standard  C  type. 

appear 

pointer  to 

Vehicle  AppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Errors  I 

Error  Name 

Reason  for  Error 

MCC  UNKNOWN  VEHICLE 

TYPE 

Unknown  vehicle  type. 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridge.h. 

SimGetSimTvpe 

See  Section  2.21.1.25.3. 

SendConsoleResponse 

See  Section  2.21.1.7.6. 

FQueue  Retrieve 

See  Section  2.21.1.13.7. 

DecodeHullToWorldMatrix 

See  Section  2.21.1.10.1. 

rad_to_mil 

Macro  defined  in 

/simnet/common/include/qlobal/sim  macros. h. 

fixedpt  to  mil 

See  Section  2.21.1.5.2. 

Lock 

See  Section  2.21.2.6.3. 

Decode  VehicleStatusM  1 

See  Section  2.21.1.20.2. 

DecodeVehicleStatusM2 

See  Section  2.21.1.21.2. 

DecodeVehicleStatusFRED 

See  Section  2.21.1.14.2. 

Unlock 

See  Section  2.21.2.6.4. 

Table  2.21-87  ProcessSimQueryRcque.st  Information. 
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2.21.1.25.5  GetCompanyFromOrg 

GetCompanyFromOrg  returns  the  company,  given  the  OTganizational  unit.  The  function  call 
is  GetCompanyFromOrg(organization).  Table  2.21-88  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 


Parameter 

Type 

organization 

pointer  to  OrganizationalUnit 

Return  Values 


Return  Value 

Type 

organization 

->hierarchy 

[companyOrgLevelJ.unitNumb 

er 

char 

Where  Typedef  Declared 

/simnet/common/include  prot 
ocol/basic.h 


Meaning _ 

the  company  unit. 


Table  2.21-88  GetCompanyFromOrg  Information, 
2.21.1.25.6  GetOldStyleCompany 

GetOldStyleCompany  returns  a  comp  any  constant  in  the  old  protocol.  The  function  call  is 
GetOldStyleCompany  (unit).  Table  2.21-89  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

unit 

pointer  to  OrganizationalUnit 

/simnet/common/include/glob 

al/basic.h 

Variable 


comoan 


Internal  Variables 


e 


char 


extern  char 


Where  Typedef  Declared 


Standard  C  type. 


See  Section  2.21.1.25.5. 


Return  Value 


assignedScoutPIt 


assignedBattalion 


assignedTACP 


assignedNothin 


Return  Values 


Type 


char 


char 


char 


char 


char 


Meaning 


Function 


GetConjpanvFromOr 


Calls 


Where  Described 


See  Section  2.21.1.25.5. 
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1  Called  Bv  1 

Function 

Where  Described 

ProcessSi  mExists  Request 

See  Section  2.21.1.25.1. 

Table  2.21-89  GetOIdStyieCompany  Information. 


2.21.1.25.7  PutCompanyInSim 

PutCompanyInSim  assigns  a  company  to  a  simulator.  The  function  call  is 
PutCompanyInSim(sim,  company).  Table  2.21-90  describes  the  parameters  used  by  this 
function. 


1  Parameters  i 

Parameter 

Where  Tvoedef  Declared 

Sim 

pointer  to  SimulatorStatus 

/simnet/mcc/include/vehjabi 

e.h 

unsiqned  char 

Standard  C  type. 

Table  2.21-90  PutCompanyInSim  Information. 


2.21.1.26  spawn. c 

/simnet/mcc/libmcc/spawn.c 


spawn.c  provides  for  mechanisms  to  control  and  coordinate  activity  and  initializing 
communications  between  parent  and  child  processes  in  the  host  MCC  and  for  terminating 
communications  upon  exit.  Table  2.21-91  describes  the  variables  used  by  spawn.c. 


1  Variables  I 

Variable 

Where  Tvpedef  Declared 

errno 

extern  int 

Standard  C  type. 

Table  2.21-91  spawn.c  Variable  Information. 


2.21.1.26.1  SpawnProcess 

SpawnProcess  forks  an  MCC  process,  p.  The  function  call  is  SpawnProcess(p).  Table 
2.21-92  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


lOT! 


Variable 


id 


n 


taraet  dir 


Internal  Variables 


e 


int 


int 


array  of  30  char 


Where  TvDedef  Declared 


Standard  C  type. 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Function 


MCC  SystemError 


Calls 


Where  Described 


See  Section  2.21.1.1 1.3 


Table  2.21-92  SpawnProcess  Information. 
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2.21.1.26.2 


LookupProcessIdentifier 


LookupProcessIdentifier  gets  a  process  number  from  a  process  ID,  pid.  The  function  call 
is  LookupProcessIdentifier(pid).  Table  2.21-93  describes  the  parameters  used  by  this 
function. 


Parameters 


Where  Tvoedef  Declared 


Standard  C  t 


Meaning 


Process  number. 


Unsuccessful. 


Table  2.21*93  LookupProcessIdentifier  Information. 


2.21.1.26.3 


LookupProcessNumber 


LookupProcessNumber  gets  a  process  ID  from  a  process  number,  p.  The  function  call  is 
LookupProcessNumber(p).  Table  2.21-94  describes  the  parameters  used  by  this  function. 


Parameters 


Parameter 


Where  Tvoedef  Declared 


Standard  C  type. 


Return  Values 


Return  Value 


mcc->plnfo[p].pid 


Meaning 


Process  ID 


Table  2.21*94  LookupProcessNumber  Information. 


2.21.1.26.4 


SignalChild 


SignalChild  sends  a  signal  ato  a  child  process,  p.  The  function  call  is  SignalChild(p,  s). 
Table  2.21-95  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Where  Tvoedef  Declared 


Standard  C  tvoe. 


Standard  C  tvoe. 


Table  2.21*95  SignalChild  Information. 
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2.21.1.27  time.c 

/simnet/mcc/libmcc/time.c 


time.c  contains  a  routine  fc/r  converting  between  Macintosh  and  Masscomp  Unix  style  time. 
Table  2.21-96  describes  the  variables  used  by  time.c. 


1  Variables  I 

Variable 

Where  Typedef  Declared 

localtimeO 

extern  pointer  to  struc  tm 

Standard  C  Library. 

timeO 

extern  long 

Standard  C  Library. 

tzsetO 

extern  void 

Standard  C  Library. 

timezone 

extern  long 

Standard  C  Library. 

daylight 

extern  int 

Standard  C  Library. 

Table  2.21<96  time.c  Variable  Information. 


2.21.1.27.1  MacintoshTime 

MacintoshTime  returns  current  local  time  in  Macintosh  format.  UNIX_TO_MAC  s  a 
constant  which  accounts  for  the  difference  between  Macintosh  time  zero  (Jan.  1, 1904)  and 
Unix  time  zero  (Jan.  1, 1970).  The  function  call  is  MacintoshTime().  Table  2.21-97 
describes  the  internal  variables  used  and  return  values  generated  by  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

(time 

Doi  nter  to  struct  tm 

Standard  C  library 

gtime 

long 

Standard  C  type. 

dst 

long 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

gtime  +  UNIX_TO_MAC  - 
timezone  +  dst 

long 

Current  local  time  in  Macintosh 
format. 

1  Calls  1 

Function 

Where  Described 

tzset 

Standard  C  Library. 

time 

Standard  C  Library. 

localtime 

Standard  C  Library. 

1  Called  By  1 

Function 

Where  Described 

ActivateConsole 

See  Section  2.21.1.7.2. 

Table  2.21-97  MacintoshTime  Information. 
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2.21.1.28  totai.c 

/simnet/mcc/libmcc/total.c 

Tallying  module  responsible  for  computing  the  total  amount  of  fuel  on  board  a  vehicle 
given  a  vehicle  status  packet  This  niodule  dispatches  the  appropriate  tallying  routine  for 
simulator  specific  fuel  loads. 


2.21.1.28.1 


TotalVehicleFuel 


TotalVehicleFuel  computes  the  total  fuel  on  board  a  vehicle,  given  a  VehicleStatus  structure 
from  that  vehicle.  The  function  call  is  TotalVehicleFuel(status,  fuel).  Table  2.21-98 
describes  the  parameters  used  and  fuctions  called  by  this  function. 


Parameter 


status 


Parameters 


e 


register  pointer  to 
VehicleStatus 


inter  to  float 


BT^ 

i 

rs 


Where  TvDedef  Declared 


/simnet/comnK>n/include/prot 
oco  I/status. h 


Standard  C  t 


Function 


Total  FuelMt 


TotalFuelM2 


TotalFuelGeneric 


Calls 


Where  Described 


See  Section  2.21.1.20.3. 


See  Section  2.21.1.21.3. 


See  Section  2.21.1.15.1. 


Table  2.21-98  TotalVehicleFuel  Information. 


2.21.1.29  truck.c 

/simnet/mcc/libmcc/truck.c 

Status  information  about  computer  controlled  vehicles  acting  as  supply  trucks  are  stored  as 
a  table  in  shared  memory,  truck.c  acts  as  the  interface  between  MCC  host  services 
manipulating  truck  resources  and  the  table  of  truck  parameters. 


2.21.1.29.1 


GetT  ruckParameters 


GetTruckParameters  finds  the  TruckParameters  object  in  shared  memory  corresponding  to 
a  particular  service  truck.  The  function  call  is  GetTruckParameters(capabilities, 
organization,  truckNumber).  Table  2.21-99  describes  the  parameters  used,  errors  returned 
and  functions  called  using  this  function. 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

pars 

register  pointer  to 
TruckParameters 

/simnet/mcc/include/MCC_par 

s.h 

Return  Values 

Return  Value 

Type 

Meaning 

pars+tmekNumber 

pointer  to  TruckParameters 

the  TruckParameters  object  in 
shared  memory 
corresponding  to  the  truck 
specified  bv  truckNumber. 

3  Errors 

Error  Name 

Reason  for  Error 

MCC  TRUCK  BADPARM 

Invalid  tmek  oarameter. 

Table  2.21-99  GetTruckParameters  Information. 

2.21.1.30  vehsubsys.c 

/simnet/mcc/libmccA'ehsubsys.c 

vehsubsys.c  contains  functions  which  fill  in  the  vehicle  subsystem  failure  bits. 

2.21.1.30,1  fill_bytes 


fill_bytes  fills  in  data  with  fill_value.  The  function  call  is  fill_bytes(data,  fill_value,  size). 
Table  2.21-100  describes  the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

data 

pointer  to  char 

Standard  C  tvoe. 

fill  value 

char 

Standard  C  type. 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

1  Called  By  1 

Function 

Where  Described 

veh_subsys_encode_g  round 
failures 

See  Section  2.21.1.30.2. 

veh_subsys_encode_air_failu 

res 

See  Section  2.21.1.30.3. 

2.21.1.30.2 


Table  2.21-100  fill_byles  Information. 
veh_subsys_encode_ground_failures 


veh_subsys_encode_ground_failures  fills  in  the  ground  vehicle  subsystems  failure  bits 
with  the  appropriate  codes.  The  function  call  is 

veh_subsys_encode_ground_failures(failures).  Table  2.21-101  desennes  the  parameiers 
used  and  functions  called  using  this  function. 
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Parameter 


failures 


Variable 


ground 


Parameters 


Where  TvDedef  Declared 


pointer  to  VehicieSubsystems  /simnet/common/include/prot 

oco  I/status,  h 


Internal  Variables 


e 


pointer  to 

GroundVehicleSubsystems 


Where  Tvoedef  Declared 


/simnet/common/include/prot 

ocol/status.h 


Function 


fill  bytes 


Calls 


Where  Described 


See  2.21.1.30.1. 


Called  B 


Function 

Where  Described 

ml  encode  failures 

See  Section  2.21.1.20.4. 

m2  encode  failures 

See  Section  2.21.1.21.4. 

Table  2.21-101  veh_subsys_encode_ground_faiIures  Information. 

2.21.1.30.3  veh_subsys_encode_air_faiIures 

veh_subsys_encode_air_failures  fills  in  the  air  vehicle  subsystems  failure  bits  with  the 
appropriate  codes.  The  funaion  call  is  veh_subsys_encode_air_failurcs(failures).  Table 
2.21-102  describes  the  parameters  used  and  functions  called  using  this  function. 


Variable 


air 


Internal  Variables 


e 


pointer  to 

AirVehicleSubsystems 


IEI73 


Where  Typedef  Declared 


/simnet/common/include/prot 

ocol/status.h 


Calls 

Function 

Where  Described 

fill  bytes 

See  2.21.1.30.1. 

Called  B 


Function 

Where  Described 

fred  encode  failures 

See  Section  2.21.1.14.3. 

Table  2.21-102  veh_subsys_encode_air_failures  Information. 
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2.21.1.31  widebdry.c 

/simnet/mcc/libnKc/widebdry.c 

widebdry.c  contains  a  function  which  allocates  an  array  of  boundary  vertices  from  a 
sequence  of  points. 


.21.1.31.1 


wide_bdry 


wide_bdry  allocates  an  array  of  boundary  vertices  {bdry_yertsp),  given  a  sequence  of 
points  center_verts[OJ  to  center _yertslmunjyerts  - 1]  creat^  by  the  caller.  The  caller 
must  later  free  the  array.  The  number  of  valid  boundary  points  in  the  array  is 
num  bvertsp.  If  the  center  verts  form  a  path  that  crosses  or  touches  itself,  the  path  from 
the  boundaiy  vertices  will  likely  cross  itself.  The  function  call  is  wide_bdry(center_verts, 
num_cverts,  width,  bdry_vertsp,  num_bvertsp).  Table  2.21-103  describes  the  parameters 
used  and  functions  call^  using  this  function. 


Parameter 


center  verts 


num  everts 


width 


bdry_vertsp 


num  bverts 


Variable 


left  normal 


left  side 


new  vector 


test  arr 


outpt  arr 


sea  size 


dot  prod 


rams 


left  vert 


num  bdrv  verts 


ht  vert 


Return  Value 


Parameters 


lEm 
ir 


ointer  to  Lono  Point 


int 


int 


pointer  to  pointer  to 
Lona  Point 


inter  to  int 


Where  Tvoedef  Declared 


/simnet/mcc/libmcc/seqintr.  h 


Standard  C  t 


Standard  C  t 


/simnet/mcc/libmcc/seginfr.h 


Standard  C  type. 


Internal  Variables 


e 


Double  Point 


Lonq  Point 


Lonq  Point 


array  of  2  Lonq  Point 


array  of  2  coded  Ipoint 


reqister  double 


reqister  double 


seqintparams 


int 


int 


int 


reqister  int 


int 


Where  Tvpedef  Declared 


/simnet/mcc/libmcc/seqintr.h 


/simnet/mcc/libmcc/seqintr.h 


/si  mnet/mcc/li  bmcc/seqi  nt  r.  h 


/simnet/mcc/libmcc/seqi  ntr.  h 


Standard  C  t 


Standard  C  type. 


/si  mnet/mcc/hbmcc/seqi  ntr.  h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Return  Values 


Type 


int 


Meaning 


Function 


SET  CODE 


ROUND  LONG 


Calls 


Where  Described 


Table  2.21-103  wide  bdry  Information. 
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2.21.1.32  MCC  errs.err 

/siinnet/mcc/libmcc^CC_errs.err 

This  file  defines  the  severity,  name,  and  textual  messages  associated  with  abnormal 
conditions  detected  by  the  MCC  host  system.  TTie  exceptions  defined  herein  are  dispatched 
to  the  standard  exception  handler  which  is  then  free  to  attempt  to  deal  with  the  exception  in 
an  appropriate  manner,  if  any. 

2.21.1.33  MCC  errs.c 

/simnet/mcc/libmcc^CC_errs.c 

MCC_errs.c  is  an  error  definition  file  generated  by  errcom.  Table  2.21-104  describes  the 
variables  used  by  MCC_errs.c. 


1  Variables  I 

Variable 

Where  Typedef  Declared 

errfacs 

extern  array  of 

MAXFACILITIES  ERRFACS 

MCC  erriist 

pointer  to  array  of  char 

Standard  C  type. 

MCC  errinfo 

array  of  ERRINFO 

Table  2.21-104  MCC_errs.c  Variable  Information 
2.21.1.33.1  MCC  errinit 


MCC_errinit  is  the  error  initialization  routine  for  the  MCC  facility.  The  function  call  is 
MCC_errinit().  Table  2.21-105  describes  the  functions  which  call  MCC_errinit. 


1  Called  By  1 

Function 

Where  Described 

InitErrorHandlino 

See  Section  2.21.1.11.1. 

mccerrinit 

See  Section  2.21.1.33.2. 

Table  2.21-105  MCC  errinit  Information. 

2.21.1.33.2  mccerrinit_ 

mccerrinit_  is  the  fortran  entry  point  to  the  error  initialization  routine  for  the  MCC  facility. 
The  function  call  is  mccerrinit-().  Table  2.21-106  describes  the  functions  called  by  this 
function. 


I  Calls  1 

Function 

Where  Described 

MCC  errinit 

See  Section  2.21.1.33.1. 

Table  2.21-106  mccerrinit  Information. 
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2.21.2  libipc 

Interprocess  Communication  Package 

Libipc  provides  several  discrete  services  related  to  interprocess  communication.  The 
services  provided  are: 

•  Queued,  time  based  alarm  events  (alarm.*); 

•  Shared  memory  management  (memory.*); 

•  A  semaphore  based  mutual  exclusion  mechanism  (lock.*);  and 

•  Transaction  and  datagram  interprocess  message  services  (yumm*.*). 

Libipc  is  used  to  coordinate  activity  across  the  distributed  process  of  the  MCC  system. 


2.21.2.1  ipc.h 

/sinuiet/rcs/libipc/ipc.h 

ipc.h  defines  the  functions  available  in  the  IPC  library.  Table  2.21-107  describes  the 
variables  used  by  ipc.h. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

ipc  mem  errno 

extern  int 

Standard  C  type. 

Table  2.21-107  ipc.h  Variable  Information 

2.21.2.2  keys.h 

/simnet/rcs/li  bipc/key  s.  h 

keys.h  defines  keys  that  uniquely  identify  shared  memory  segments,  groups  of  semaphores 
and  message  queues  all  used  for  inter- process  communication. 

2.21.2.3  alarm.h 

/simnet/rcs/libipc/alarm.h 

alarm.h  is  the  header  file  associated  with  alarm.c  (see  Section  2.21 .2.4). 

2.21.2.4  alarm.c 

/simnct/rcs/libipc/alarm.c 

alami.c  contains  routines  which  provide  an  alarm  service  similar  to  that  of  ttie  alann(2; 
system  call,  but  differing  in  that  multiple  alarms  can  be  pending.  Table  2.21-108  describes 
the  variables  used  by  alarm.c. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

alarmSchedule 

Alarm 

/simnet/rcs/libipc/alarm.h 

alarmsEnabled 

int 

Standard  C  type 

Table  2,21-108  alarm.c  Variable  Information. 
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2.21.2.4.1  InitAlarms 

InitAlarms  initializes  the  alarm  package.  The  function  call  is  InitAlarmsQ.  Table  2.21-109 
describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

IPC  errinit 

See  Section  2.21.2.13.1. 

Table  2.21-109  InitAlarms  Information. 

2.21.2.4.2  SetAlarm 

SetAlarm  makes  a  new  entry  in  the  schedule  of  upcoming  alarms,  delay  is  how  long  to 
wait  before  alarm  is  duc\fnc  is  a  pointer  to  function  call  when  alarm  is  due;  param  is  the 
parameter  to  give  the  function  when  it  is  called.  The  function  call  is  SetAlarm(delay,  fnc, 
param).  Table  2.21-1 10  describes  the  parameters  used  and  errors  returned  using  this 
function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

delay 

int 

Standard  C  type. 

(fnc){) 

pointer  to  int 

Standard  C  type. 

param 

Iona 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

prevAlarm 

unsigned 

Standard  C  type. 

a 

register  Alarm 

/simnet/rcs/libipc/alarm.h 

P1 

register  Alarm 

/si  mnet/rcs/libipc/alarm  .h 

P2 _ 

register  Alarm 

/simnet/rcs/libipc/alarm.h 

int 

Standard  C  type. 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

Alarm 

Unsuccessful. 

a 

Alarm 

New  alarm. 

I  Errors  I 

Error  Name 

Reason  for  Error 

IPC  ALARM  MEMORY 

Not  enough  memory. 

Table  2.21-110  SetAlarm  Information. 


2.21.2.4.3  CancelAlarm 


CancelAlarm  removes  an  entry,  a,  from  the  schedule  of  upcoming  alarms.  The  function 
call  is  CancelAlarm(a).  Table  121-1 1 1  describes  the  parameters  used  by  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

a 

register  Alarm 

/si  mnet/rcs/libipc/alarm .  h 

941 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

prevAlarm 

unsipned 

Standard  C  type. 

P1 

repister  Alarm 

/simnet/rcs/libipc/alarm.h 

P2 

repister  Alarm 

/simnet/rcs/libipc/alarm.h 

oldPriority 

int 

Standard  C  type. 

Table  2.21*111  CancelAlarm  Information. 

2.21.2.4.4  AlarmsEnabled 

AlarmsEnabled  enables  or  disables  the  alarm  interrupts.  The  value  returned  is  non-zero  if 
and  only  if  the  alarms  were  enabled  at  the  time  of  the  call.  The  function  call  is 
AlarmsEnabled(on).  Table  2.21-1 12  describes  the  parameters  used  by  this  function. 


I  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

on 

int 

Standard  C  type. 

Internal  Variables 

I  Variable 

Type 

Where  Tvpedef  Declared 

int 

Standard  C  type. 

oldAlarmsEnabled 

int 

Standard  C  type. 

now 

lonp 

Standard  C  type. 

a 

repister  Alarm 

/si  mnet/rcs/libipc/alarm .  h 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

alarmsEnabled 

int 

No  Change  in  state. 

OldAlarmsEnabled 

int 

Changed  state  of  alarms. 

Table  2.21>112  AlarmsEnabled  Information. 

2.21.2.4.5  DispatchAlarm 

DispatchAIarm  handles  a  SIGALARM  signal  by  calling  the  next  scheduled  alami  client 
function.  The  function  call  is  DispatchAlarm(sig).  Table  2.21-1 13  describes  the 
parameters  used  by  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

sip 

int 

Standard  C  type 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

now 

long 

Standard  C  type. 

a 

register  Alarm 

/simnet/rcs/libipc/alarm.h 

int 

Standard  C  type 

Table  2.21-113  DispatchAIarm  Information. 
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2.21.2.5  error.c 

/simnet/rcs/libipc/error.c 

error.c  contains  a  routine  which  reports  an  error  encountered  in  a  system  call.  Table  2.21- 
114  describes  the  variables  used  by  error.c. 


Variable 


errno 


svs  nerr 


svs  erriist 


IGTH 


Variables 


e 


extern  int 


extern  int 


extern  pointer  to  array  of  char 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Table  2.21*114  error.c  Variable  Information. 


2.21.2.5.1  IPC_SystemError 

IPC_SystemError  reports  an  error  encountered  in  a  system  call.  functionName  is  the  name 
of  the  function  you  were  in  when  the  call  was  made  and  systemCallName  is  the  name  of  the 
system  call  made.  The  function  call  is  IPC_SystemError(functionName, 
systemCallName).  Table  2.21-1 15  describes  the  parameters  used  by  this  function. 


Parameters 


Parameter 


functionName 


systemCallName 


Variable 


s 


str 


IBTi! 
IIS 
IIS 


inter  to  char 


inter  to  char 


Internal  Variables 


e 


inter  to  char 


array  of  10  char 


iBm 

IIS 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Function 


Attach  Locks 


ResetLocks 


Lock 


Unlock 


RemoveLockL 


AttachMsoQueue 


RemoveMsoQueue 


YUMMCleanU 


Transact 


RcvMs 


SendData 


Called  B 


Where  Described 


See  Section  2.21.2.6.1. 


See  Section  2.21.2.6.2. 


See  Section  2.21.2.6.3. 


See  Section  2.21.2.6.4. 


See  Section  2.21.2.6.5. 


See  Section  2.21.2.8.1. 


See  Section  2.21.2.8.2. 


See  Section  2.21.2.10.5. 


See  Section  2.21.2.10.9. 


See  Section  2.21.2.12.1. 


See  Section  2.21.1.12.3. 


Table  2.21-115  IPC_SystemError  Information. 
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2.21.2.6  lock.c 

/simnetAcs/libipc/lock.c 

lock.c  contains  routines  which  implement  exclusive-access  locks  using  semaphores.  Table 
2.21-1 16  describes  the  variables  used  by  lock.c. 


Variables 


Variable 


errno 


extern  int 


Where  Tvoedef  Declared 


Standard  C  t 


Table  2.21-116  lock.c  Vriable  Information. 


2.21.2.6.1  AttachLocks 

AttachLocks  gets  a  group  of  semaphores  to  use  as  locks.  If  the  group  has  not  yet  been 
created,  it  is  created  at  this  time,  key  is  the  key  for  the  semaphores,  n  is  the  number  of 
semaphores  and  first  is  returned  TRUE  if  the  semaphore  group  was  created.  This  function 
is  not  good  for  checking  if  a  key  is  already  in  use.  No  error  will  be  returned,  just  the 
semaphore  id.  The  function  call  is  AttachLocks(key,  n,  first).  Table  2.21-1 17  describes 
the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


Where  Typedef  Declared 


Standard  C  tvoe. 


Standard  C  t 


Standard  C  tvoe. 


Variable 


semid 


firstFla 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Return  Values 


Return  Value 


semid 


Meanin 


Semaphore  id. 


Function 


IPC  errinit 


I  PC  SystemError 


ResetLocks 


Calls 


Where  Described 


See  Section  2.21.2.13.1. 


See  Section  2.21.2.5.1. 


See  Section  2.21.2.6.2. 


Called  B 


Function 

Where  Described 

YUMMInit 

See  Section  2.21.2.10.1. 

Table  2.21-117  AttachLocks  Information. 
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2.21.2.6.2  ResetLocks 

ResetLocks  initializes  a  group  of  semaphores  representing  locks,  semid  is  semaphore  id 
and  n  is  the  number  of  semaphores  in  the  group.  The  function  call  is  ResetLocks(semid, 
n).  Table  2.21-1 18  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


semid 


n 


Variable 


lEiT? 


Internal  Variables 


e 


Where  Tvpedef  Declared 


Standard  C  t 


Standard  C  type. 


Where  Tvoedef  Declared 


Standard  C  t 


Function 


IPC  SvslemError 


Calls 


Where  Described 


See  Section  2.21.2.5.1. 


Function 


Attach  Locks 


Called  B 


Where  Described 


See  Section  2.21.2.6.1. 


Table  2.21-118  ResetLocks  Information. 


2.21.2.6.3  Lock 

Lock  locks  a  shared  resource.  The  function  call  is  Lock(semid,  n).  Table  2.21-119 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


semid 


n 


Variable 


Internal  Variables 


e 


struct  sembuf 


IEi73 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Where  Typedef  Declared 


/usr/mclude/sys/sem.h 


Function 


IPC  SystemError 


Calls 


Where  Described 


See  Section  2.21.2.5.1. 


Called  B 


Function 

Where  Described 

GetInternProcID 

See  Section  2.21.2.12.7. 

CloseSocket 

See  Section  2.21.2,10.4. 

OpenSocket 

See  Section  2.21.2.10.3. 

Table  2.21-119  Lock  Information. 
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2.21.2.6.4  Unlock 


Unlock  unlocks  a  shared  resource.  The  function  call  is  Unlock(semid,  n).  Table  2.21-120 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

semid 

int 

Standard  C  type. 

n 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Tvoedef  Declared 

SOD 

struct  sembuf 

1  Calls  1 

Function 

Where  Described 

IPC  SvstemError 

See  Section  2.21.2.5.1. 

1  Called  By  1 

Function 

Where  Described 

GetInternProcID 

See  Section  2.21.2.12.7. 

CloseSocket 

See  Section  2.21.2.10.4. 

OpenSocket 

See  Section  2.21.2.10.3. 

Table  2.21*120  Unlock  Information. 


2.21.2.6.5  RemoveLocks 


RemoveLocks  removes  a  group  of  semaphores,  described  by  key,  from  the  system.  The 
function  call  is  RemoveLocks(key).  Table  2.21-121  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

key 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

semid 

int 

Standard  C  tyce 

Calls 

Function 

Where  Described 

IPC  SystemError 

See  Section  2.21.2.5.1 

Table  2.21-121  RemoveLocks  Information. 
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2.21.2.7  memory.c 

/simnet/rcsAibipc/memory.c 

memory.c  contains  routines  for  managing  the  memory  shared  among  processes.  Table 
2.21-122  describes  the  variables  used  by  memory.c. 


I  Variables  I 

Variable 

Type 

Where  Tvpedef  Declared 

ipc  mem  ermo 

int 

Standard  C  type. 

errno 

extern  int 

Standard  C  type. 

Table  2.21>122  memory.c  Variable  Information. 

2.21.2.7.1  AttachSharedMem 

AttachSharedMem  attaches  to  memory  shared  among  processes.  When  it  is  getting  the 
memory,  it  figures  out  if  this  process  is  the  first  one  to  get  it  and  returns  so  that  some 
initialization  can  take  place,  key  is  the  key  for  the  shar^  memory  and  size  is  the  size  of  the 
memory,  first  returns  TRUE  if  this  is  the  first  process  to  create  shared  memory.  This 
process  cannot  be  used  to  determine  if  key  is  ahready  in  use.  It  can  only  return  the  shared 
memory  id.  The  function  call  is  AttachSharedMem(key,  size,  first).  Table  2.21-123 
describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


Parameter 


Parameters 


inter  to  ini 


Where  Tvoedef  Declared 


Standard  C  tvoe. 


Standard  C  type. 


Standard  C  type. 


Variable 


shmat 


sbrk 


id 


Internal  Variables 


e 


extern  array  of  char 


extern  array  of  char 


int 


inter  to  char 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


Standard  C  t 


Standard  C  type. 


Return  Value 


charp 


Return  Values 


Type 


pointer  to  char 


pointer  to  char 


Meaning _ 


Unsuccessful.  Check 

ioc  mem  ermo  for  error  code. 


Pointer  to  shared  memory. 


Error  Name 


IPC  SHMEM  SBRK 


IPC  SHMEM  BRK 


(PC  SHMEM  SHMGET 


IPC  SHMEM  SHMAT 


Errors 


Reason  for  Error 


Couldn’t  grow  process. 


Couldn’t  grow  process. 


Couldn’t  get  region. 


Couldn’t  attach  to  region. 


Function 


IPC  errinit 


Calls 


Where  Described 


See  Section  2.21.2.13.1. 
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1  Called  By  I 

Function 

Where  Described 

YUMMInit 

See  Section  2.21.2.10.1. 

Table  2.21<123  AttachSharedMem  Information. 


2.21.2.7.2  RemoveSharedMem 


RemoveSharedMem  removes  a  block  of  shared  memory,  described  by  key  and  address, 
from  the  system.  The  function  call  is  RemoveSharedMem(key,  address).  Table  2.21-124 
describes  Ae  parameters  used  and  errors  returned  by  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

key 

int 

Standard  C  type. 

address 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

shmid 

1  int  1 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Meaning 

-1 

int 

Unsuccessful. 

1  Errors  1 

Error  Name 

Reason  for  Error 

IPC  SHMEM  RM  SHMGET 

IPC  SHMEM  SHMDT 

Couldn't  delete  the  region. 

IPC  SHMEM  SHMCTL 

Couldn’t  remove  the  region. 

Table  2.21-124  RemoveSharedMem  Information. 


2.21.2.8  msgqueue.c 

/simnet/rcs/libipc/msgqueue.c 


msgqueue.c  contains  routines  to  create,  attach  and  remove  a  message  queue  Table  2.21- 
125  describes  the  variables  used  by  msgqueue.c. 


1  Variables  I 

Variable 

Type 

Where  Tvpedef  Declared 

errno 

extern  int 

Standard  C  type 

Table  2.21-125  msgqueue.c  Variable  Information. 
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2.21.2.8.1  AttachMsgQueue 

AttachMsgQueue  is  used  to  create  a  message  queue  and  its  ID  or  return  the  ID  of  an  already 
existing  message  queue,  key  is  the  message  queue  key  znd  first  returns  1  if  the  message 
queue  was  created.  This  routine  cannot  be  us^  to  determine  if  key  is  already  in  use.  It 
will  just  return  the  ID  of  the  corresponding  message  queue.  The  function  caU  is 
AttachMsgQueue(key,  first).  Table  2.21-126  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameters 


Parameter 


first 


lEin 


variable 


ueuelO 


r 


I  Em 


Internal  Variables 


e 


Where  Tvpedef  Declared 


Standard  C  t 


Standard  C  t 


Where  Tvbedef  Declared 


Standard  C  t 


c 


Return  Value 


ueuelD 


IBT! 


Return  Values 


Meanin 


ID  of  messaoe  Queue. 


Function 


IPC  errinit 


I  PC  SvstemError 


Calls 


Where  Described 


See  Section  2.21.2.13.1. 


See  Section  2.21.2.5.1. 


Called  B 


Function 

Where  Described 

YUMMInit 

See  Section  2.21.2.10.1. 

Table  2.21-126  AttachMsgQueue  Information. 

2.21.2.8.2  RemoveMsgQueue 

RemoveMsgQueue  removes  the  message  queue  associated  with  key.  The  function  call  is 
RemoveMsgQueue(key).  Table  2.21-127  describes  the  parameters  used,  errors  returned 
and  functions  called  using  this  function. 
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2.21.2.9  yumm.h 

/simnet/rcs/libipc/yumm.h 


yumm.h  is  the  external  include  file  for  YUMM.  Programs  using  YUMM  procedures  need 
to  include  this  file.  Table  2.21-128  describes  the  variables  used  by  this  file. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

YUMMSocket 

unsiqned  char 

Standard  C  type. 

Table  2.21-128  yumiii.h  Variable  Information. 


2.21.2.10  yummextern.c 

/simnetAx:s/libipc/yummextem.c 

yummextern.c  contains  all  the  external  routines  for  YUMM  (Y et  Unother  Message-passing 
Mechanism).  Table  2.21-129  describes  the  variables  used  by  yummextern.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

errno 

extern  int 

Standard  C  type. 

Table  2.21-129  yummextern.c  Variable  Information. 
2.21.2.10.1  YUMMInit 

YUMMInit  does  the  initialization  for  the  system,  if  necessary,  and  for  this  process.  It 
allocates  and  attaches  a  chunk  of  shared  memory  for  the  socket  table,  allocates  and  attaches 
the  semaphore  table  and  allocates  and  attaches  a  system-wide  message  queue.  It  also 
generates  the  internal  process  id.  It  returns  nothing  if  everything  is  ok,  or  the  system  error 
if  there  is  a  problem.  Warning:  This  procedure  is  NOT  foolproof.  If  a  non- YUMM 
related  process  already  allocated  shar^  memory,  a  semaphore  group  or  a  message  queue 
with  the  same  key  as  YUMM  uses,  havoc  could  result.  Check  keys.h.  The  function  call  is 
YUMMInitQ.  Table  2.21-130  describes  the  internal  variable  used  and  functions  called 
using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

first 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

AttachSharedMem 

See  Section  2.21.2.7.1. 

InitShMem 

See  Section  2.21.2.12.5. 

AttachLocks 

See  Section  2.21.2.6.1. 

AttachMsqQueue 

See  Section  2.21.2.8.1. 

IPC  errinit 

See  Section  2.21.2.13.1. 

Table  2.21-130  YUMMInit  Information. 
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2.21.2.10.2  YUMMProcess 

YUMMProcess  initializes  process  specific  information  such  as  procid  and  the  entry  in  the 
socket  table  for  this  process’  synchronous  requests.  It  also  allocates  the  semaphore  for  this 
process,  procname  is  the  name  of  the  process  used  to  register  a  socket.  The  function  call 
is  YUMMProcess(procname).  Table  2.21-131  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

procname 

pointer  to  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

Cleanup  DeadSockets 

See  Section  2.21.2.12.6. 

GetInternProcID 

See  Section  2.21.2.12.7. 

SetUpSvnchReq 

See  Section  2.21.2.12.8. 

Table  2.21-131  YUMMProcess  Information. 


2.21.2.10.3  OpenSocket 

OpenSocket  dynamically  allocates  a  socket  and  fills  in  the  entry  using  information  which  is 
passed  in  and  information  which  it  can  figure  out.  It  uses  a  semaphore  to  avoid  resource 
conflicts.  usrASTHdlr  is  a  pointer  to  the  user’s  AST  handler,  sktName  is  the  name  to 
associate  with  the  socket  (it  can  be  no  more  than  31  characters),  astprio  is  the  priority  the 
_sendast  should  use  for  this  AST,  sktNum  is  the  socket  allocated,  or  NULL  if  we  don’t 
care  to  get  it  and  usrTrace  is  a  pointer  to  the  debugging  routine  called  when  AST  comes. 
The  function  call  is  (^nSocket(usrASTHdlr,  sktName,  astprio,  sktNum,  usrTrace). 
Table  2.21-132  describes  the  parameters  used,  errors  return^  and  functions  called  using 
this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

(usrASTHdlr){) 

function  that  returns  pointer  to 
void 

Standard  C  type. 

SktName 

pointer  to  char 

Standard  C  type. 

astprio 

int 

Standard  C  type. 

SktNum 

pointer  to  YUMMSocket 

/simnet/rcs/libipc/yumm.h 

(usrT  race)() 

function  that  returns  pointer  to 
void 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

temp 

YUMMSocket 

/si  mnet/rcs/libipc/y  umm.  h 

Return  Values 

Return  Value 

Meaning 

0 

short 

Socket  number  allocated. 

-1 

short 

Socket  number  not  allocated, 
error  code  returned  in  errno. 
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1  Errors  1 

Error  Name 

Reason  for  Error 

IPC_DUP_SOCKET_NAME 

The  current  socket  name  is  a  duplicate  of  one  already  in  the 
table. 

IPC  SOCKET  TABLE  FULL 

The  socket  table  is  full. 

Calls 

Function 

Where  Described 

Lock 

See  Section  2.21.2.6.3. 

LkUpSocket 

See  Section  2.21.2.10.10. 

Unlock 

See  Section  2.21.2.6.4. 

Table  2.21-132  OpenSocket  Information. 


2.21.2.10.4  CloseSocket 

CloseSocket  closes  the  designated  socket  according  to  always.  If  always  is  TRUE  it  closes 
the  socket  no  matter  what,  otherwise,  it  checks  to  see  if  there  are  outstanding  requests  on 
that  socket  before  closing  and  it  will  not  close  if  there  are  any.  skt number  is  the  socket 
name  of  the  entry  to  close.  The  function  call  is  CloseSocket(skmumber,  always).  Table 
2.21-133  describes  the  parameters  used,  errors  returned  and  functions  called  using  this 
function. 


Parameter 


sktnumber 


always 


Parameters 


IEH:: 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  type. 


Variable 


iot; 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard  C  type. 


Return  Value 


0 


-1 


Return  Values 


Type 


short 


short 


Meaning  _ 


Successful. 


Requests  outstanding,  check 
errno  for  error  code. 


Error  Name 


IPC  MORE  REOS 


Errors 


Reason  for  Error 


More  requests  for  this  socket  are  outstandin 


Calls 

Function 

Where  Described 

Lock 

See  Section  2.21.2.6.3. 

Unlock 

See  Section  2.21.2.6.4. 

Called  B 


Function 

Where  Described 

CleanupDeadSockets 

See  Section  2.21.2.12.6. 

CleanupSockets 

See  Section  2.21.2.12.4. 

Table  2.21-133  Close.Sockcl  Information. 
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Parameters 


Parameter 


dstSkt 


msqKind 


msaLen 


msoData 


inter  to  char 


Where  Typedef  Declared 


/simnet/rcs/libiDc/vumm.h 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Variable 


messtype 


Internal  Variables 


e 


messaoeType 


Where  Typedef  Declared 


/simnet/rcs/libipc/y  u  mmint .  h 


Return  Values 


Return  Value 


-1 


SendData(messtype, 
msqKinq,  msqLen,  msqData) 


Type 


int 


Meaning 


Unsuccessful.  Check  error 
code  returned  in  errno. 


Successful.  Should  return  0. 


Error  Name 


IPC  BAD  SOCKET 


Errors 


Reason  for  Error 


Socket  not  opened  by  process. 
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1  Calls  1 

Function 

Where  Described 

Send  Data 

See  Section  2.21.2.12.3. 

Table  2.21-135  SendMsg  Information. 

2.21.2.10.7  SendReq 

SendReq  is  used  for  two-way  message  passing.  It  sends  a  request  via  an  AST  according  to 
the  information  found  at  dstSkt.  It  expects  a  response  to  be  sent  to  rspSkt.  It  assumes  that 
dstSkt  and  rspSkt  are  valid.  A  bit  of  info  indentifying  the  request  may  be  passed  in 
msginfo  if  the  user  so  desires.  dstSkt  is  the  socket  to  deliver  AST  to  now,  msgKind  is  the 
kind  of  request  (user-defined),  msgLen  is  the  length,  in  bytes,  of  msgData  and  msgData  is 
a  pointer  to  the  message  buffer.  The  function  call  is  SendReq(dstSkt,  rspSkt,  msginfo, 
msgKind,  msgLen,  msgData).  Table  2.21-136  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dstSkt 

YUMMSocket 

/simnet'rcs/libipc/yumm.h 

rspSkt 

YUMMSocket 

/si  mnet/rcs/li  bi  pc/y  u  mm .  h 

msainfo 

long 

Standard  C  type. 

msoKind 

long 

Standard  C  type. 

msoLen 

int 

Standard  C  type. 

msgData 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

messtype 

messaqeType 

/simnet/rcs/libipc/yummint.h 

tid 

short 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful.  Check  error 
code  returned  in  errno. 

SendData(messtype, 
msqKinq,  msgLen,  msgData) 

int 

Successful  Should  return  0. 

Errors 

Error  Name 

Reason  for  Error 

IPC  BAD  SOCKET 

Socket  not  opened  by  process. 

IPC  REQ  FULL 

Request  table  full. 

Calls 

Function 

Where  Described 

GrabReqEntry 

See  Section  2  21.2  12.2 

SendData 

See  Section  2.21.2  12.3. 

Table  2.21-136  SendReq  Information. 
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2.21.2.10.8  SendRsp 

SendRsp  is  used  for  two-way  mesage  passing.  It  sends  a  response  via  an  AST  according 
to  the  information  found  through  reqlD.  reqlD  is  the  number  identifying  the  request  this 
response  is  for,  msgKind  is  the  kind  of  request  (user-defined),  msgLen  is  the  length,  in 
bytes,  of  msgData  and  msgData  is  a  pointer  to  the  message  buffer.  The  function  call  is 
SendRspO.  Table  2.21-137  describes  the  parameters  us^  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

reqlD 

messaaeTvoe 

/si  mnet/rcs/libipc/yu  mmi  nt .  h 

msoKind 

Iona 

Standard  C  type. 

msqLen 

int 

Standard  C  type. 

msqData 

pointer  to  char 

Standard  C  type. 

Return  Values 


Return  Value 

Type 

Meaning 

SendData(reql0.s,  msgKind, 
msgLen,  msgData) 

int 

0  if  successful.  -1  if 
unsuccessful,  error  code 
returned  in  errno. 

Calls 

Function 

Where  Described 

SendData 

See  Section  2.21.2.12.3. 

Table  2.21-137  SendRsp  Information. 


2.21.2.10.9  Transact 

Transact  is  used  for  two-way  message  passing.  It  sends  out  a  request  and  does  not  return 
until  a  response  is  received  or  timeout  has  expired.  It  uses  astpause()  to  accomplish  this. 
dstSkt  is  the  socket  to  deliver  AST  to  now,  msgKind  is  the  kind  of  request  (user-defined), 
msgLen  is  the  length,  in  bytes,  of  msgData  and  msgData  is  a  pointer  to  the  message  buffer. 
rcvKind  returns  the  kind  of  response  received.  rcvLen  is  initialized  to  the  max  length  of 
rcvData  and  returns  the  length  of  the  received  data.  rcvData  is  a  pointer  to  the  data  in  the 
response,  timeout  is  the  time,  in  milliseconds,  to  wait  for  a  response.  The  function  call  is 
Transact(dstSkt,  msgKind,  msgLen,  msgData,  rcvKind,  rcvLen,  rcvData,  timeout).  Table 
2.21-138  describes  ^e  parameters  used,  errors  returned  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dstSkt 

YUMMSockef 

/simnet/rcs/libipc/yumm.h 

msgKind 

lonq 

Standard  C  type. 

msqLen 

int 

Standard  C  type. 

msqData 

pointer  to  char 

Standard  C  type. 

rcvKind 

Standard  C  type. 

rcvLen 

pointer  to  int 

Standard  C  type. 

rcvData 

pointer  to  char 

Standard  C  type. 

timeout 

int 

Standard  C  type. 
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Internal  Variables 

Variable 

Where  Tvpedef  Declared 

messType 

1  messaqeType  I 

/si  mnet/rcs/libipc/yu  mmint .  h 

savepri 


short 


messaaeBuf 


int 


Standard  C  t 


/si  mnet/rcs/libipc/yu  mmint  .h 


Standard  C  t 


Return  Value 


Return  Values 


Type 


int 


int 


Meaning  _ 


Successful. 


Unsuccessful.  Error  code 
returned  in  errno. 


Error  Name 


IPC  BAD  SOCKET 


IPC  REQ  FULL 


IPC  TIMED  OUT 


IPC  NO  MESSAGE 


IPC  WRITE  OVERRUN 


Errors 


Reason  for  Error 


Socket  not  explicitly  opened  by  process. 


Request  table  full. 


Timeout  exceeded  before  response  arrived. 


No  response  found  in  messaoe  queue. 


More  data  in  response  than  can  be  put  in  the  rcvData  buffer. 


Function 


ismsmusi 


SendData 


IPC  SvstemError 


Calls 


Where  Described 


See  Section  2.21.2.12.2. 


See  Section  2.21.2.12.3. 


See  Section  2.21.2.5.1. 


Table  2.21-138  Transact  Information. 


2.21.2.10.10  LkUpSocket 

LkUpSocket  looks  for  name  in  the  socket  table  and  returns  the  socket  number,  sktnum, 
associated  with  it.  It  does  a  linear  search.  If  name  is  NULL,  the  function  returns  FALSE. 
The  function  call  is  LkUpSocket(name,  sktnum).  Table  2.21-139  describes  the  parameters 
used  by  this  function. 
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1  Called  By  I 

Function 

Where  Described 

OpenSocket 

See  Section  2.21.2.10.3. 

Table  2.21*139  LkUpSocket  Information. 


2.21.2.10.11  GetSocketName 


GetSocketName  returns  the  name  associated  with  a  given  socket  Note  that  if  the  socket  is 
closed,  the  name  is  meaningless.  The  function  call  is  GetSocketName(skmum,  name). 
Table  2.21-140  describes  the  parameters  used  by  this  function. 


I  Parameters  j 

Parameter 

Where  Typedef  Declared 

sktnum 

unsiqned  char 

Standard  C  type. 

name 

pointer  to  char 

Standard  C  type. 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

FALSE 

short 

Socket  number  is  invalid, 

'name'  is  meaninoless. 

TRUE 

short 

Socket  number  is  valid,  socket 
name  is  returned  in  ‘name’ 

Table  2.21*140  GetSocketName  Information. 


2.21.2.10.12  ReportYUMMStatus 

Report YUMMStatus  returns  the  status  of  the  system  and  of  each  process  registered  in  the 
statTable.  The  status  consists  of  listing  the  various  messge  pasing  counts,  the  ipc 
mechanisms  involved  with  YUMM  and  information  about  the  socket  table.  The  function 
call  is  Report YUMMStatusO.  Table  2.21-141  describes  the  internal  variables  used  by  this 
function. 


I  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

oldpri 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

Table  2.21*141  ReportYUMMStatus  Information. 


2.21.2.11  yumminit.h 

/simnet/rcs/libipc/yumminit.  h 


yumminit.h  is  the  internal  include  file  for  the  YUMM  sources.  Table  2.21-142  describes 
the  variables  used  by  yumminit.h. 


I  Variables  I 

Variable 

Where  Typedef  Declared 

YUMMData 

extern  YUMMGlobals 

/si  mnet/rcs/libi  pc/yu  mmi  nit .  h 

Table  2.21*142  yumminit.h  Variable  Information. 
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yummintern.c  contains  all  the  internal  routines  to  Yet  Unoiher  Message-passing  Mechanism 
(YUMM).  Table  2.21-143  describes  the  variables  used  by  yummintern.c 


Variables 


Variable 


errno 


asthandier 


YUMMData 


extern  int 


extern  int 


YUMMGIobals 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


/simnet/rcs/libipc/vumminit.h 


Table  2.21-143  yummintern.c  Variable  Information. 
2.21.2.12.1  RcvMsg 

RcvMsg  is  a  generic  AST  handler.  All  ASTs  come  to  RcvMsg  first  before  the  user’s  trace 
procedure  and  the  user’s  AST  handler  are  called.  It  grabs  parameters  off  the  message 
queue  using  param  and  passes  them  to  the  user’s  AST  handler  and  trace  program,  if 
provided,  oldpc  is  the  old  program  counter  and  oldpr  is  the  old  priority.  The  function  call 
is  RcvMsg(param,  oldpc,  oldpri).  Table  2.21-144  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


Parameter 


aram 


oldpc 


older 


r 


Parameters 


ID73 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

msgbuf 

messaqeBuf 

/si  mnet/rcs/libipc/yu  mmint .  h 

msQlnfo 


msoLen 


sockEnt 


messaaeType 


sktEnt 


/simnet/rcs/libipc/yu  mmint .  h 


Standard  C  t 


Standard  C  t 


/simnet/rcs/libipc/yummint.h 


Errors 

Error  Name 

Reason  for  Error 

IPC  NO  MESSAGE 

Expected  messaqe  was  not  found  on  the  mesaqe  queue. 

IPC  UNKNOWN  TYPE 

An  unknown  type  of  messqe  was  received. 

Function 


IPC  SystemError 


Calls 


Where  Described 


See  Section  2.21.2.5.1. 


Table  2.21-144  RcvMsg  Information. 
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2.21.2.12.2  GrabReqEntry 

GrabReqEntry  enters  information  for  this  request  into  the  next  free  entry  in  rqstTable.  This 
table  is  used  to  hold  user-defined  information  for  asynchronous  requests  and  to  hold  a  flag 
which  signifies  if  a  response  has  come  in  yet  for  a  synchronous  requests.  It  returns  the 
index  of  the  new  table  entry  if  successful  and  -1  otherwise.  The  function  caU  is 
GrabReqEntry(msgInfo,  srcSkt).  Table  2.21-145  describes  the  parameters  used  and  errors 
returned  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

msqinfo 

lonq 

Standard  C  type. 

srcSkt 

YUMMSocket 

/simnet/rcs/libipc/yumm.  h 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

i 

short 

Standard  C  type. 

QSIilSHliBIHBHHHii 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

i 

short 

Index  of  new  table  entry. 

-1 

short 

Unsuccessful. 

I  Errors  I 

Error  Name 

Reason  for  Error 

IPC  REQ  FULL 

Request  table  is  already  lull. 

I  Called  By  I 

Function 

Where  Described 

Transact 

See  Section  2.21.2.10.9. 

SendReq 

See  Section  2.21.2.10.7. 

Table  2.21-145  GrabReqEntry  Information. 


2.21.2.12.3  SendData 

SendData  does  the  actual  sending  of  data  by  putting  parameters  on  the  message  queue  and 
then  sending  an  AST  to  the  receiving  process  so  it  knows  to  read  off  of  the  message  queue. 
It  will  not  send  to  a  closed  socket.  It  truncates  messages  which  are  bigger  than 
MAXMSGSIZE.  msgType  describes  the  message  as  either  one-way,  a  synchronous  or 
asynchronous  request  or  an  asynchronous  respwnes.  msgKind  describes  the  kind  of 
message,  msgLen  is  the  length  of  the  data  buffer  and  msgData  is  a  pointer  to  an 
MCCMessageBuffer.  The  function  call  is  SendData(msgType,  msgKind,  msgLen, 
msgData).  Table  2.21-146  describes  the  parameters  used,  errors  returned  and  functions 
called  using  this  function. 
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Parameters 


Parameter 


e 


msqKind 


msoLen 


Data 


Variable 


msoBuf 


sockEnt 


irs 

ion 


inter  to  char 


Internal  Variables 


e 


messaaeBuf 


sktEnt 


Where  Tvoedef  Declared 


/simnet/rcs/libi 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Where  Tvpedef  Declared 


/si  mnet/rcs/libioc/vu  mmint .  h 


/si  mnet/rcs/libipc/yu  mmi  nt .  h 


Return  Values 


Return  Value 


Type 

Meaning 

int 

Successful. 

int 

Unsuccessful. 

Error  Name 


I  PC  TOO  LONG 


IPC  PROCESS  MISSING 


IPC  CLOSED  SOCKET 


Errors 


Reason  for  Error 


The  messaoe  was  too  Ion 


The  process  has  disappeared. 


The  socket  is  closed. 


Calls 

Function 

Where  Described 

IPC  SvstemError 

See  Section  2.21.2.5.1. 

Function 


Transact 


SendRs 


SendRe 


SendMs 


2.21.2.12.4 


Called  B 


Where  Described 


See  Section  2.21.2.10.9. 


See  Section  2.21.2.10.8. 


See  Section  2.21.2.10.7. 


See  Section  2.21.2.10.6. 


Table  2.21-146  SendData  Information. 


CleanupSockets 


CleanupSockets  is  called  from  YUMMCIcanup  to  close  any  outstanding  sockets.  Tbe 
function  call  is  CleanupSockets().  Table  2.21-147  describes  the  internal  variables  used  and 
functions  called  using  this  function. 
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1  Called  By  1 

Function 

Where  Described 

YUMMCleanUo 

See  Section  2.21.2.10.5. 

Table  2.21-147  CleanupSockets  Information. 

2.21.2.12.5  InitShMem 

InitShMem  initializes  shared  memory.  This  entails  initializing  all  the  YUMMHdlr  entries  in 
the  socket  table  and  initializing  the  process  id  used  to  get  an  internal  process  id  for  each 
process.  The  function  call  is  InitShMem().  Table  2.21-148  describes  the  internal  variables 
used  by  this  function. 


I  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

I  Called  By  I 

Function 

Where  Described 

YUMMInit 

See  Section  2.21.2.10.1. 

2.21.2.12.6 


Table  2.21-148  InitShMem  Information. 
CleanupDeadSockets 


CleanupDeadSockets  goes  through  the  socket  table  and  closes  those  for  which  the 
corresponding  process  is  no  longer  alive.  The  function  call  is  CleanupDeadSockets(). 
Table  2.21-149  describes  the  internal  variables  used  and  functions  called  using  this 
function. 


I  Internal  Variables 

Variable 

Type 

Where  Typedef  Declared  1 

i 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

CloseSocket 

See  Section  2.21.2.10.4. 

Called  By 

Function 

Where  Described 

YUMMProcess 

See  Section  2.21.2.10.2. 

Table  2.21-149  CleanupDeadSockets  Information. 
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2.21.2.12.7  GetInternProcID 

GetIntemProcID  assigns  a  unique  one  byte  number  to  procid.  procid  will  be  between  1 
and  NUMSYNCH-1,  inclusive.  It  assigns  procid  by  incrementing  the  byte  counter  in 
shared  memory.  The  function  call  is  GetIntemProcID().  Table  2.21-150  describes  the 
functions  callt^  using  this  function. 


1  Calls  1 

Function 

Where  Described 

Lock 

See  Section  2.21.2.6.3. 

Unlock 

See  Section  2.21.2.6.4. 

Called  Bv 

Function 

Where  Described 

YUMMProcess 

See  Section  2.21.2.10.2. 

Table  2.21-150  GetInternProcID  Information. 


2.21.2.12.8  SetUpSynchReq 

SetUpSynchReq  sets  up  a  socket  table  entry  to  be  used  when  a  synchronous  request  is 
made.  It  sets  up  the  entry  indexed  by  the  internal  process  id.  The  function  call  is 
SetUpSynchReq(procname).  Table  2.21-151  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Type, 

Where  Typedef  Declared 

procname 

pointer  to  char 

Standard  C  type. 

Calied  By 

Function 

Where  Described 

YUMMProcess 

See  Section  2.21.2.10.2. 

Table  2.21-151  SetUpSynchReq  Information. 

2.21.2.13  libipcerrs.c 

/simnet/rcs/libipcAibipcerrs.c 


libipcerrs.c  is  the  error  definition  file  generated  by  errcom. 
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Calls 


Table  2.21-153  ipcerrinit  Information. 

2.21.2.14  libipcerrs.err 

/simnet/rcs/libipc/libipcerrs.err 

libipcerrs.err  defines  the  errors  detected  and  reported  by  the  IPC  library. 

2.21.3  libbbd 

Reference  the  Vehicles  CSCI  documentation  Section  2. 1.5.1. 

2.21.4  iibmatrix 

Reference  the  Vehicles  CSCI  documentation  Section  2.6.2. 

2.21.5  libmove 

Reference  the  Vehicles  CSCI  documentation  Section  2.6.6. 

2.21.6  libshm 

Reference  the  Vehicles  CSCI  documentation  Section  2.6.5. 


Where  Described 

See  Section  2.21.2.13.1. 


Function 

IPC  errinit 
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2.21.7  libtdb 

Terrain  Database  Access 

libtdb  is  a  set  of  utilities  for  accessing  the  generic  application  database  used  by  the  MCC, 
SAP  and  PVD.  It  provides  a  mechanism  for  localiz^  terrain  caching.  Optionally,  direct 
memory  access  can  be  used  instead  of  caching  (implemented  in  "memory .c")It  also 
generates  a  number  of  useful  data  constructs  based  on  the  current  terrain,  such  as  the 
elevation  at  a  given  (x,y)  coordinate,  a  hull/world  cosine  matrix  for  a  given  (x,y) 
coordinate  and  heading  or  a  list  of  obstructions  to  ground  traversal  in  a  given  area. 

2.21.7.1  cache.b 

/simnet/common/libsrc/libtdb/cache.h 


cache.h  contains  definitions  needed  for  the  terrain  caching  system.  Table  2.21-154 
describes  the  variables  used  by  cache.h. 


1  Variables  I 

Variable 

Where  Tvpedef  Declared 

tcc 

extern 

TERRAIN  CACHE  CONTRO 

L 

/simnet/common/libsrc/libtdb/ 

cache.h 

cache_map 

extern  pointer  to 

CACHE  MAP 

/simnet/comnwn/libsrc/libtdb/ 

cache.h 

Tbie  2.21>154  cache.h  Variable  Information. 


2.21.7.2  map.h 

/simnet/commoa/libsrc/libtdb/map.h 


map.h  defines  types  representing  map  coordinates  and  functions  for  manipulating  these 
types. 


2.21.7.3  objects. h 

/simnet/common/libsrcAibtdb/objects.h 

objects.h  provides  symbolic  names  for  objects  in  the  database. 

2.21.7.4  tdb.h 

/simnet/common/libsrc/libidb/tdb.h 

tdb.h  contains  definitions  necessary  for  using  the  routines  in  libtdb.  Table  2.2 1-155 
describes  the  variables  used  by  tdb.h. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

tdbjnfo 

extern  TDBJNFO 

/simnet/common/libsrc/libtdb/t 

db.h 

tdb_errno 

extern  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

Table  2.21-155  tdb.h  Variable  Information. 
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2.21.7.5  tdb  local.h 

/simnet/common^ibsn:/libtdb/tdb_local.h 


tdb_local.h  contains  all  the  declarations  which  are  external  to  the  source  files  but  internal  to 
the  module.  Table  2.21-156  describes  the  variables  used  by  tdb_local.h. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

size_of_patch_guards 

extern  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

patchjndices 

extern  pointer  to  INT_4 

/simnet/common/inciude/glob 
ai/mass  stdc.h 

tdb_patch_guards 

extern  pointer  to 

PATCH  GUARD 

/simnet/common/libsrc/libtdb/t 

errain.h 

guards  included 

extern  char 

Standard  C  type. 

ldb_stalus 

extern  TDB_STATUS 

/simnet/common/libsrc/libtdb/t 

db.h 

tdb  method  used 

extern  int 

Standard  C  type. 

Table  2.21-156  tdb_local.h  Variable  Information. 

2.21.7.6  terrain. h 

/simnet/common/libsrc/Iibtdb/terrain.h 

terrain.h  defines  the  terrain  database  format. 

The  database  begins  with  a  database  header  of  type  DB_HEADER.  This  structure  is  made 
up  of  two  other  structures,  DB_INFORMATION  and  DB_MAP.  The  database  information 
h^der  field  contains  such  information  as  the  database  name  and  version  number,  physical 
dimensions  of  terrain  patches  represented,  mi^ellaneous  features  represented,  and  UTM  to 
Cartesian  coordinate  offsets  for  the  given  database.  The  database  map  contains  offsets 
from  the  beginning  of  the  database  to  the  patch  indices,  patch  guards,  and  the  first  patch  in 
the  database. 

The  database  header  is  followed  by  the  patch  indices.  These  indices  are  4-byte  integers. 
Each  index  is  an  offset  from  the  beginning  of  the  database  to  its  corresponding  patch. 
Patches  are  numbered  from  0  to  n- 1 ,  from  left  to  right  and  from  bottom  to  top.  A  macro, 
PATCH_INDEX(),  defined  in  "tdb.h"  takes  a  pointer  to  a  TDB_POINT  and  returns  the 
corresponding  index.  For  n  patches  there  are  n+1  indices,  so  that  the  number  of  bytes  for  a 
patch  can  be  determined  by  index[n+l]  -  index[n]  for  all  cases. 

The  patch  indices  are  followed  by  a  list  of  patch  guards  with  type  PATCH_GUARD,  one 
per  patch.  These  patch  guards  contain  minima/maxima  information  for  the  given  patch, 
allowing  intervisibility  routines  to  determine  if  a  patch  needs  to  be  examined  more  closely. 

The  listing  of  patch  guards  is  followed  by  the  listing  of  the  actual  patches.  Each  patch  is 
prefaced  by  a  header  of  t>pe  PATCH_HEADER.  A  patch  header  contains  information 
about  the  number  of  vertices,  edges,  polygons,  objects,  trees,  treelines,  and  tree  canopies 
in  the  patch,  as  well  as  offsets  from  the  beginning  of  the  patch  to  each  of  these  entities. 

Following  the  patch  header  is  the  list  of  vertices,  which  are  type  TDB_POINT.  The  order 
in  which  the  vertices  appear  is  undefined. 
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The  vertices  are  followed  by  the  list  of  edges  in  the  patch.  Each  edge  has  the  type 
EDGE_DESCRIPTOR.  The  two  vertices  of  the  edge  appear  in  the  same  order  as  they 
appear  in  the  list  of  vertices,  thereby  eliminating  the  ne^  to  check  both  edge  vl->v2  and 
edge  v2->vl  when  doing  edge  comparisons.  Mges  also  have  a  grid  locator  word.  The 
patch  is  divided  into  a  4  x  4  grid.  TTie  grid  boxes  are  numbered  from  1  to  16,  starting  from 
the  lower-left  comer  and  going  left  to  right,  then  bottom  to  top.  If  an  edge  enters  a  given 
grid  box,  the  appropriate  bit  is  set. 

The  list  of  edges  is  followed  by  the  list  of  polygons  in  the  patch.  A  polygon  is  represented 
by  a  POLYGON_DESCRIPTOR.  The  polygon  descriptor  contains  a  grid  locator  word, 
indices  into  the  vertex  list  for  the  polygon  vertices,  and  a  polygon  info  bit  field. 
Consecutive  pairs  of  vertices  represent  edges  of  the  polygon.  Rather  than  use  bit  fields, 
#defines  and  macros  are  provided  for  accessing  the  poly  info  bit  fields. 

A  list  of  objects  follows  the  list  of  polygons  in  the  patch.  An  object  is  defined  by  an 
OBJECT_DESCRIPTOR.  The  object  descriptor  contains  a  grid  locator  word,  the  four 
vertices  of  the  object,  and  an  object  info  bit  field.  Again,  #defines  and  macros  are  provided 
to  access  these  bit  fields. 

The  object  list  is  followed  by  a  list  of  trees  of  type  TREE_DESCRIPTOR.  The  tree 
descriptor  contains  the  type,  centroid,  radius  and  height  of  the  tree. 

The  next  group  of  data  in  the  patch  is  the  list  of  treelines.  Each  treeline  is  represented  by  a 
header  of  type  TREELINE_HEADER  followed  by  a  list  of  vertices  of  type  TDB_POINT. 
The  treeline  header  contains  the  number  of  vertices  in  the  treeline  and  the  treeline’s  type, 
extents,  height,  and  elevation.  It  also  contains  the  number  of  bytes  for  the  treeline,  to  make 
access  of  successive  treelines  easier. 

The  last  group  of  data  in  the  patch  is  a  list  of  tree  canopies.  Each  canopy  is  represented  by 
a  CANOPY_HEADER,  followed  by  a  list  of  the  treelines  in  the  canopy,  a  list  of  canop>’ 
polygon  vertices,  a  list  of  canopy  polygon  edges,  and  finally  a  list  of  canopy  polygons. 

The  vertices/edges/polygons  scheme  is  analogous  to  that  used  for  terrain  polygons. 
Currently,  no  direct  support  for  tree  canopies  is  available  from  the  libtdb  routines. 

2.21.7.7  cache_alloc.c 

/simnet/common/libsrcAibtdb/cache_alloc.c 

cache_alloc.c  contains  routines  for  allocating  memory  for  and  terminating  the  terrain 
caching  system.  Table  2.21-157  describes  the  variables  used  by  cache _^loc.c. 
patch  guards  obj  and  patch  indices  ohj  are  variables  that  are  only  used  when  SIMBFLY 
is  defined. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

total  cache  memory  require 
d 

INT_4 

/simnet/common-'include/giob 
al/mass  stdc.h 

patch  quards  obj 

extern  OID 

patch,  indices  obi 

OID 

Table  2.21-157  cache  alloc.c  Variable  Information. 
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Variable 


size_of_cache_map 


size  of  indices 


Internal  Variables 


e 


INT  4 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Return  Value 


Return  Values 


Type 

Meaning 

int 

Unsuccessful. 

int 

Successful. 

Error  Name 


TE  CACHE  MALLOC 


TE  LOCK 


Errors 


Reason  for  Error 


malloc  failed  for  terrain  cache. 


Could  not  lock  down  oaoes  in  memo 


Calls 

Function 

Where  Described 

init  patch  indices 

See  Section  2.21.7.10.1. 

init  terrain  cache 

See  Section  2.21.7.10.2. 

init  cache  ma 


Function 


tdb  init  cache 


See  Section  2.21.7.10.3. 


Called  B 


Where  Described 


See  Section  2.21.7.27.1. 


Table  2.21-158  MassComp  cache_init  Information. 
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Variable 


size_of_cache_map 


size  of  indices 


Internal  Variables 


e 


INT  4 


Where  Tvpedef  Declared 


/simnet/comn)on/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Return  Values 


Return  Value 


Type 


int 


int 


Meaning 


Unsuccessful. 


Successful. 


Error  Name 


TE  CACHE  MALLOC 


Errors 


Reason  for  Error 


malloc  failed  for  terrain  cache. 


Function 


init  patch  indices 


init  terrain  cache 


init  cache  ma 


Calls 


Where  Described 


See  Section  2.21.7.10.1. 


See  Section  2.21.7.10.2. 


See  Section  2.21.7.10.3. 


Called  B 


Function 

Where  Described 

tdb  init  cache 

See  Section  2.21.7.27.1. 

Table  2.21-159  Butterfly  cachejnit  Information. 

2.21.7.7.2  cache_and_file_terminate 

cache_and_file_terminate  terminates  the  terrain  caching  system,  freeing  the  index  file  space 
and  closing  the  terrain  binary  or  poly  file.  The  function  call  is  cache_and_file_terminate() 
Table  2.21-160  describes  the  internal  variables  used,  errors  returned  and  functions  called 
using  this  function  with  a  MassComp  computer.  Table  2.21-161  describes  the  internal 
variables  used,  errors  returned  and  functions  called  using  this  function  with  a  Butterfly. 
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1  Called  Bv  1 

Function 

Where  Described 

tdb  terminate 

See  Section  2.21.7.27  2. 

Table  2.21-160  MassComp  cache_and_nie_terininate  Information. 


1  Return  Values  1 

Return  Value 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

1  Errors  1 

Error  Name 

Reason  for  Error 

TE  NOT  INITED 

Cache  has  not  been  initialized. 

1  Called  By  1 

Function 

Where  Described 

tdb  terminate 

See  Section  2.21.7.27.2. 

Table  2.21-161  Butterfly  cache_an(I_rile_terminate  Information. 

2.21.7.8  cache_cntl.c 

/simnet/common/libsrcAibtdb/cache_cntl.c 

cache_cntl.c  contains  routines  for  enabling  and  disabling  the  terrain  cache. 

2.21.7.8.1  tdb_cache_enablc 

tdb_cache_enable  enables  the  terrain  cache.  The  routine  resets  the  cache  structure  by 
calling  init_terrain_cache()  and  init_cache_map(),  and  then  sets  the  value  of 
tdb  status. cache  enabled  to  TRUE  to  make  the  cache  available.  The  function  call  is 
tdb_cache_enable().  Table  2.21-162  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

init  terrain  cache 

See  Section  2.21.7.10.2. 

init  cache  map 

See  Section  2.21.7.10.3. 

Table  2.21-162  tdb_cache_enable  Information. 
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2.21.7.8.2  tdb_cache_(lisable 

tdb_cache_disable  disables  the  terrain  cache  by  setting  the  value  of 
tdb  status. cache  enabled  to  FALSE.  While  the  cache  is  disabled,  the  memory  which  it 
uses  can  be  re-used  to  grab  large  "stripes"  of  consecutive  patches  using  the  function 
tdb_get_stripe().  When  the  user  is  finished  with  a  stripe  of  patches,  the  cache  must  be  re¬ 
enabled  by  maidng  a  call  to  tdb_cache_enable().  Note  that  all  patches  currently  cached  are 
removed  when  the  cache  is  disabled.  The  function  call  is  tdb_cache_disable().  Table  2.21- 
163  describes  this  function. 


1  Called  By  I 

Function 

Where  Described 

tdb  init  memory 

Se  Section  2.21.7.25.1. 

Table  2.21-163  tdb_cache_disable  Information. 

2.21.7.8.3  tdb_p_cache_enabled 

tdb_p_cache_enabled  returns  the  value  of  tdb  status. cache  enabled.  If  the  value  is  TRUE, 
the  terrain  cache  is  enabled;  if  the  value  is  FALSE,  the  terrain  cache  is  disabled.  The 
function  call  is  tdb_p_cache_enabled().  Table  2.21-164  describes  the  return  values 
generated  by  this  function. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

int 

Cache  is  enabled. 

FALSE 

int 

Cache  is  disabled. 

Table  2.21-164  tdb_p_cache_enabled  Information. 

2.21.7.9  cache_data.c 

/simnet/common/libsrc/libtdb/cache_data.c 

cache_data.c  contains  storage  allocation  for  globals  in  the  terrain  caching  system.  Table 
2.21-165  describes  the  variables  used  by  cache_data.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

patchjndices 

pointer  to  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

tcc 

TERRAIN  CACHE  CONTRO 

L 

/si  mnet/co  mmon/libs  rc/libtdb/ 
cache. h 

cache_map 

pointer  to  CACHE_MAP 

/simnet/common/libsrc/libtdb/ 
cache. h 

size_of_patch_gurards 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

tdb_patch_guards 

pointer  to  PATCH_GUARD 

/si  mnet/co  mmo  n/libs  rc '  li  btdb/t 
errain.h 

guards  included 

char 

Standard  C  type 

Table  2.21-165  cache  data.c  Variable  Information. 
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2.21.7.10  cache_init.c 

/simnet/comnK)n/libsrc/libtdb/cache_init.c 

cache_iniLc  contains  routines  for  initializing  the  terrain  caching  system.  patch_guards_obj 
is  only  used  if  SIMBFLY  is  defined.  Table  2.21-166  describes  Ae  variables  used  by 
cache_init.c. 


1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

patch  Quards  obj 

OID 

Table  2.21-166  cache  init.c  Variable  Information. 
2.21.7.10.1  init_patch_indices 

init_patch_indices  initializes  the  patch  indices  by  reading  in  the  index  file,  patch  jndices 
points  to  the  locked  memory  allocated  to  hold  the  entire  index  file.  This  index  array 
contains  pointers  to  each  patch  in  the  terrain  file,  with  one  index  per  patch.  The  function 
call  is  init_patch_indices^atch_indices).  Table  2.21-167  describes  the  parameters  used, 
errors  returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

patchjndices 

register  pointer  to  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

bytesjo_read 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful 

1  Errors  1 

Error  Name 

Reason  for  Error 

TE  OPEN  READ 

Open  or  read  on  database  failed. 

1  Called  By  1 

Function 

Where  Described 

memory  init 

See  Section  2.21.7.25.2. 

cache  init 

See  Section  2.21.7.7.1. 

Table  2.21-167  init_patch_indices  Information. 
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2.21.7.10.2  init  terrain  cache 


init_terTain_cache  initializes  the  local  terrain  cache,  tccp  is  a  pointer  to  the  local  terrain 
cache  control.  number  ofjKitches  is  the  number  of  patches  in  the  cache.  The  function 
caU  is  init_terrain_cache(tccp,  number_of_patches).  Table  2.21-168  describes  the 
parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

tccp 

register  pointer  to 

TERRAIN  CACHE  CONTRO 

L 

/simnet/common/libsrc/libtdb/ 
cache. h 

number_ofj3atches 

INT  4 

/si  mnet/co  mmo  n/i  nclude/glob 
al/mass  stdc.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  INT_4 

/si  mnet/common/i  nclude/glob 
al/mass  stdc.h 

start  data 

register  pointer  to  char 

Standard  C  type. 

1  Called  By  I 

Function 

Where  Described 

tdb  cache  enable 

See  Section  2.21.7.8.1. 

cache  init 

See  Section  2.21.7.7.1. 

Table  2.21-168  inU_terrain_cache  Information. 
2.21.7.10.3  init_cache_map 


init_cache_map  initializes  the  cache  map.  cache  jnap  maps  the  patch  indices  to  cache 
indices.  The  function  call  is  init_cache_map(cache_map).  Table  2.21-169  describes  the 
parameters  used  by  this  function. 


1  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

cache_map 

register  pointer  to 

CACHE  MAP 

/simnet/common/libsrc/libtdb/ 
cache. h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

register  INT_4 

/si  mnet/co  m  mo  n/i  nclude/glob 
al/mass  stdc.h 

1  Called  By  1 

Function 

Where  Described 

tdb  cache  enable 

See  Section  2.21.7.8.1 

cache  init 

See  Section  2.21.7.7.1. 

Table  2.21-169  init_cache_niap  Information. 
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2.21.7.10.4  init_patch_guards 


init_patch_guards  initializes  the  patch  guards.  Patch  guards  are  the  minimum  and 
maximum  elevation  limits  of  the  patch,  used  in  intervisibility  calculations.  The  patch 
guards  for  the  entire  terrain  data  base  can  be  read  into  locked  memory.  The  function  call  is 
init_patch_guards().  Table  2.21-170  describes  the  internal  variables  used,  errors  returned 
and  functions  call^  using  this  function  with  a  MassComp  computer.  Table  2.21-171 
describes  the  internal  variables  used,  errors  returned  and  functions  called  using  this 
function  with  a  Butterfly. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  PATCH_GUARD 

Unsuccessful 

tdbj)atch_guards 

pointer  to  PATCH_GUARD 

Pointer  to  the  successfully 
initialized  patch  guards. 

Errors 

Error  Name 

Reason  for  Error 

TE  CACHE  MALLOC 

malloc  failed  for  terrain  cache. 

TE  LOCK 

Could  not  lock  paoes  down  in  memory. 

TE  OPEN  READ 

Open  or  read  on  the  database  failed. 

Table  2.21-170  MassComp  init_patch_guards  Information. 


1  Return  Values  1 

Return  Value 

Meaning 

NULL 

pointer  to  PATCH_GUARD 

Unsuccessful 

tdbj3atch_guards 

pointer  to  PATCH_GUARD 

Pointer  to  the  successfully 
initialized  patch  guards 

1  Errors  1 

Error  Name 

Reason  for  Error 

TE  CACHE  MALLOC 

malloc  failed  for  terrain  cache. 

TE  OPEN  READ 

Open  or  read  on  the  database  failed. 

Table  2.21-171  Butterfly  init_patch_guards  Information. 

2.21.7.11  cache_query.c 

/simnet/common/libsrc/libtdb/cache_query.c 

cache_query.c  contains  routines  for  retrieving  local  terrain  and  preprocessed  terrain  patches 
from  the  cache. 

2.21.7.11.1  terrain_cache_inquire 

terrain_cache_inquire  retrieves  a  preprocessed  terrain  patch  from  cache,  patch  index  is  the 
number  of  the  patch  of  interest.  The  function  returns  a  pointer  to  the  start  of  the  terrain 
patch  if  successful,  a  null  pointer  otherwise.  The  function  call  is 

terrain_cache_inquire(patch_index).  Table  2.21-172  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 
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Parameters 

Parameter 

Type 

Where  Typedef  Declared 

patchjndex 

1NT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

cachejndex 

register  INT_4 

/simnet/common/i  nclude/glob 
al/mass  stdc.h 

inquiry_size 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

bytes_read 

INT_4 

/si  mnet/co  mmon/i  nclude/glob 
al/mass  stdc.h 

ot  ont 


/simnet/common/include/glob 
at/mass  stdc.h 


Standard  C  tvoe. 


Return  Values 


Return  Value  Type  _ 


NULL _  _  pointer  to  char  _ 


tcc.cache[cache_mdex].data  pointer  to  char 


Meaning  _ 


Unsuccessful 


Pointer  to  the  start  of  the 
terrain  patch. 


Error  Name 


TE  NO  SLOT 


TE  PATCH  2BIG 


TE  OPEN  READ 


Errors 


Reason  for  Error 


Can’t  find  slot  in  the  cache  queue. 


A  terrain  patch  was  larqer  than  MAX  LOCAL  PATCH  SIZE. 


en  or  read  on  the  database  failed. 


Function 


rotate  queue 


dequeue  terrain  patch 


enqueue  terrain  patch 


Calls 


Where  Described 


See  Section  2.21.7.12.3. 


See  Section  2.21.7.12.1. 


See  Section  2.21.7.12.2. 


Function 


tdb  oet  terrain 


Called  B 


Where  Described 


See  Section  2.21.7.18.1. 


Table  2.21-172  terrain_cache_inquire  Information. 

2.21.7.11.2  tdb_get_stripe 

tdb_get_stripe  returns  a  pointer  to  a  "stripe"  of  consecutive  terrain  patches  from  the  patch 
indiciated  hystart  up  to  and  including  the  patch  indicated  by  end.  Individual  patches  can  be 
extracted  from  the  "stripe"  using  the  information  in  the  global  array  pointed  to  by 
patch  indices.  It  reuses  the  cache  memory,  so  caching  must  be  turned  off  before  you  cali 
it,  and  turned  back  on  when  you  are  done  (ttlb_disable_cache()  and  tdb_enable_cache()). 

If  the  patches  cannot  be  retrieved,  a  null  pointer  is  returned  and  the  global  terrain  error 
variable  tdb  errno  is  set.  The  function  call  is  tdb_get_stripe(start,  endj.  Table  2.21-173 
describes  the  parameters  used  and  errors  returned  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

start 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

end 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

inquiry_size 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

bytes_read 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  char 

Unsuccessful. 

tcc.cache[01.data 

pointer  to  char 

Pointer  to  block  of  patches. 

1  Errors  I 

Error  Name 

Reason  for  Error 

TE  STRIPE  2BIG 

A  terrain  patch  was  larger  than  MAX  LOCAL  PATCH  SIZE. 

TE  OPEN  READ 

Open  or  read  on  the  database  failed. 

Table  2.21-173  tdb_get_stripe  Information. 

2.21.7.12  cache_queue.c 

/sininet/conimon/libsrc/libtdb/cache_queue.c 

cache_queue.c  contains  routines  for  queueing  patches  in  the  terrain  cache.  Table  2.21-174 
describes  the  variables  used  by  cache_queue.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

tcc 

extern 

TERRAIN  CACHE  CONTRO 

L 

/simnet/common/libsrc/libtdb/ 

cache.h 

Table  2.21-174  cache_queue.c  Variable  Information. 
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2.21.7.12.1  dequeue_terrain_patch 

dequeue_terrain_patch  removes  the  patch  specified  by  cache  index  from  the  terrain  queue. 
The  function  call  is  dequeue_terrain^atch(cache_index).  Table  2.21-175  describes  the 
parameters  used  by  this  function. 


Parameters  I 

Parameter 

Where  Typedef  Declared 

cachejndex 

register  INT_4 

/si  mnet/comnfX)  n/i  nclude/glob 
al/mass  stdc.h 

Called  By  I 

Function 

Where  Described 

See  Section  2.21.7.11.1. 

rotate  queue 

See  Section  2.21.7.12.3. 

Table  2.21-175  dequeue_terrain_patch  Information. 

2.21.7.12.2  enqueue_terrain_patch 

enqueue_terrain_patch  places  the  patch  specified  by  cache  Jndex  onto  the  end  of  the  terrain 
queue.  The  function  call  is  enqueue_terrain_patch(cache_index).  Table  2.21-176  describes 
the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

cachejndex 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

Called  By 

Function 

Where  Described 

terrain  cache  inquire 

See  Section  2.21.7.11.1. 

rotate  queue 

See  Section  2.21.7.12.3. 

Table  2.21-176  enqueue_terrain_patch  Information. 
2.21.7.12.3  rotate_queue 

rotate_queue  is  called  by  terrain„cache_inquire.  The  patch  specified  by  index  is  first 
removed  from  the  terrain  queue,  then  placed  on  the  end  of  the  queue.  TTie  function  call  is 
rotate_queue().  Table  2.21-177  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

index 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

Return  Values 

Return  Value 

Type 

Meaning 

index 

int 

the  patch  index 

1  n 
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1  Calls  1 

Function 

Where  Described 

dequeue  terrain  patch 

See  Section  2.21.7.12.1. 

enqueue  terrain  patch 

See  Section  2.21.7.12.2. 

Called  By 

Function 

Where  Described 

terrain  cache  inquire 

See  Section  2.21.7.11.1. 

Table  2.21-177  rotate_queue  Information. 

2.21.7.13  consistent.c 

/simnet/common/libsrc/libtdb/consistent.c 

consistent.c  contains  a  routine  which  checks  terrain  consistency. 

2.21.7.13.1  tdb_consistent 

tdb_consistent  is  used  in  debugging  to  check  the  terrain  consistency.  The  function  call  is 
tdb_consistent().  Table  2.21-178  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

i 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

j 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

coord 

TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

1  Calls  1 

Function 

Where  Described 

tdb  qet  z 

See  Section  2.21.7.16.2. 

tdb  error 

See  Section  2.21.7.17.1. 

Table  2.21-178 


tdb  consistent  Information. 
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2.21.7.14  data.c 

/simnet/common/libsrc/libtdb/datac 


data.c  contains  all  the  storage  allocation  for  globals  in  the  tdb  library.  Table  2.21-179 
describes  the  variables  used  by  data.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

tdbjnfo 

TDBJNFO 

/simnet/common/libsrc/libtdb/t 

db.h 

tdb_status 

TDB_STATUS 

/si  mnet/co  mmo  n/li  bs  rc/libtdb/t 
db.h 

tdb  errno 

int 

Standard  C  type. 

tdb  err  strina 

array  of  120  char 

Standard  C  type. 

patch_guards 

pointrto  PATCH_GUARD 

/simnet/comnfK>n/libsrc/libtdb/t 

errain.h 

tdb  method  used 

int 

Standard  C  type. 

Table  2.21-179  data.c  Variable  Information. 


2.21.7.15  dump.c 

/simnet/common/libsrc/libtdb/dump.c 


dump.c  contains  routines  for  dumping  out  information  about  a  terrain  patch  during 
debugging.  Table  2.21-180  describes  the  variables  used  by  dump.c. 


I  Variables  I 

Variable 

Where  Typedef  Declared 

terrain_object_names 

pointer  to  array  of 

MAX_NUM_OBJECT_TYPES 

char 

Standard  C  type. 

terrain  Jextijre_names 

pointer  to  array  of 

MAX_NUM_TE)aURE_TYPE 

Schar 

Standard  C  type. 

tdb  dumpfile 

pointer  to  FILE 

Standard  C  type. 

Table  2.21-180  dump.c  Variable  Information. 


2.21.7.15.1  tdb_set_dumpfile 


tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file  for  the  tdb  print  and  idb 
dump  routines.  Otherwise,  by  default,  output  is  sent  to  stderr.  The  function  call  is 
tdb_set_.dumpfile(rile).  Table  2.21-181  describes  the  parameters  used  by  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

file 

pointer  to  FILE 

Standard  C  type 

Called  By 

Function 

Where  Described 

tdb  init  memory 

See  Section  2.21.7.25  1. 

tdb  init  cache 

See  Section  2.21  7.27.1 

Table  2.21-181  tdb  set  dumpfile  Information. 
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2.21.7.15.2  tdb_get_dumpfile 

tdb_get_dumprile  returns  a  pointer  to  tdb  dumpfile.  The  function  call  is 
tdb_get_dumprile().  Table  2.21-182  describes  the  return  values  generated  by  this  function. 


1  Return  Values  1 

Return  Value 

Meaning 

tdb dumpfile 

pointer  to  FILE 

Pointer  to  tdb dumpfile. 

1  Called  By  I 

Function 

Where  Described 

tdb  print  version 

See  Section  2.21.7.31.1. 

tdb  print  format  compatible 

See  Section  2.21.7.31.2. 

tdb  print  db  format 

See  Section  2.21.7.31.3. 

Table  2.21-182  tdb_get_dumpfile  Information. 

2.21.7.15.3  tdb_dump_terrain 

tdb_dump_terrain  prints  all  information  in  the  patch  specified  by  coord.  The  result  is 
voluminous,  and  is  intended  for  debugging.  By  default  all  output  is  sent  to  stderr. 
tdb_set_dumprile  allows  you  to  specify  an  alternate  output  file.  The  function  returns  0  if 
there  is  no  problem  accessing  the  requested  patch.  Otherwise,  -1  is  returned  and  the  global 
terrain  error  variable  tdb  errno  is  set.  The  function  call  is  tdb_dump_terrain(coord).  Table 
2.21-183  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

coord 

pointer  to  TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

terrain 

register  pointer  to  char 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

Calls 

Function 

Where  Described 

tdb  qet  terrain 

See  Section  2.21.7.18.1. 

dump  terrain 

See  Section  2.21.7.15.4. 

Table  2.21-183  tdb_dump_terrain  Information. 
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2.21.7.15.4  dump_terrain 


dump_teiTain  gets  information  for  a  particular  patch.  The  function  call  is 
dump_terrain(patch).  Table  2.21-184  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

patch 

reaister  pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

register  INT_4 

/simnet/comrrwn/include/glob 
al/mass  stdc.h 

no_polygons 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

no_objects 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

no_trees 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

nojreelines 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

no_edges 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

no_canopies 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

no_canopy_vertices 

INT_4 

/si  mnel/common/i  nclude/glob 
al/mass  stdc.h 

no_canopy_edges 

INT_4 

/simnet/common/include/glob 
al/mass  stdc  h 

vertices 

register  pointer  to 

TERRAIN  POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

patch_header 

register  pointer  to 

PATCH  HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

polygons 

pointer  to 

POLYGON  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

objects 

pointer  to 

OBJECT  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

treeline 

pointer  to 

TREELINE  HEADER 

/simnel/common/libsrc/libtdb/t 

errain.h 

trees 

pointer  to 

TREE  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

edges 

pointer  to 

EDGE  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

canopies 

pointer  to  CANOPY_HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

canopy_vertices 

pointer  to  TERRAIN_POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

canopy_edges 

pointer  to 

EDGE  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 
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1  Calls  1 

Function 

Where  Described 

tdb  print  polygon 

See  Section  2.21.7.15.5. 

tdb  print  edge 

See  Section  2.21.7.15.6. 

tdb  print  object 

See  Section  2.21.7.15.7. 

tdb  print  triine 

See  Section  2.21.7.15.8. 

tdb  print  tree 

See  Section  2.21.7.15.10. 

tdb  print  canopy 

See  Section  2.21.7.15.14. 

Called  By 

Function 

Where  Described 

tdb  dump  terrain 

See  Section  2.21.7.15.3. 

Table  2.21>184  dump_terrain  Information. 


2.21.7.15.5  tdb_print_poIygon 

tdb_print_polygon  prints  information  for  a  specified  polygon,  poly  is  a  pointer  to  the 
polygon  descriptor,  vertices  is  a  pointer  to  Ae  terrain  point.  By  default  all  output  is  sent 
to  stderr.  tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file.  The  function  call 
is  idb_print_polygon(poly,  vertices).  Table  2.21-185  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameter 


poly 


vertices 


Parameters 


e 


register  pointer  to 
POLYGON  DESCRIPTOR 


register  pointer  to 
TERRAIN  POINT 


Where  Typedef  Declared 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


Variable 


no  vertices 


internal  Variables 


register  INT_4 


register  INT_4 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/comnx)n/include/glob 
al/mass  stdc.h 


Function 


lint  arid  locator 


GET  POLY  NUM  VERTS 


GET  POLY  PRIORITY 


GET  POLY  SHADING 


P  POLY  DUPLICATE 


GET  POLY  SOIL 


GET  POLY  MIN  X 


GET  POLY  MIN  Y 


GET  POLY  MIN  Z 


GET  POLY  MAX  X 


GET  POLY  MAX  Y 


GET  POLY  MAX  Z 


Calls 


Where  Described 


See  Section  2.21.7.15.11. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terram.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 
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1  Called  Bv  1 

Function 

Where  Described 

dump  terrain 

See  Section  2.21.7.15.4. 

Table  2.21>185  tdb_print_polygon  Information. 

2.21.7.15.6  tdb_print_edge 

tdb_print_edge  prints  informatitm  for  a  specified  edge,  edge  is  a  pointer  to  the  edge 
descriptor,  vertices  is  a  pointer  to  the  terrain  point  By  default  all  output  is  sent  to  stderr. 
tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file.  The  function  call  is 
tdb_print_edge(edge,  vertices).  Table  2.21-186  describes  the  parameters  used  and 
functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

edge 

register  pointer  to 

EDGE  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

vertices 

register  pointer  to 

TERRAIN  POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

Calls 

Function 

Where  Described 

print  arid  locator 

See  Section  2.21.7.15.11. 

Called  By 

Function 

Where  Described 

dump  terrain 

See  Section  2.21.7.15.4. 

Table  2.21-186  tdb_print_edge  Information. 

2.21.7.15.7  tdb_print_object 

tdb_print_object  prints  information  about  the  specified  object.  By  default  all  output  is  sent 
to  stderr.  tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file.  The  function 
call  is  tdb_print_object(object).  Table  2.21-187  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

object 

register  pointer  to 

OBJECT  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

type 

unsigned  INT  4 

/simnet/common/include/glob 
al/mass  stdc.h 
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1  Calls  1 

Function 

Where  Described 

GET  OBJECT  TYPE 

Macro  defined  in/simnetycommon/libsrc/libtdb/terrain.h. 

GET  OBJECT  MIN  X 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MIN  Y 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MIN  2 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MAX  X 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MAX  Y 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MAX  Z 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

Called  Bv 

Function 

Where  Described 

dump  terrain 

See  Section  2.21.7.15.4. 

Table  2.21-187  tdb_prInt_object  Information. 

2.21.7.15.8  tdb_print_trline 

tdb_print_trline  prints  information  for  a  specified  treeline.  It  assumes  that  the  treeline 
header  is  followed  in  memory  by  the  list  of  vertices  for  that  treeline  (as  in  the  terrain  cache). 
By  default  all  output  is  sent  to  stderr.  tdb_set_dumpfile  allows  you  to  specify  an  alternate 
output  file.  The  function  call  is  tdb_print_trline(treeline).  Table  2.21-188  describes  the 
parameters  used  and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

treeline 

register  pointer  to 

TREELINE  HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  INT_4 

/simnet/commonAinclude/glob 
al/mass  stdc.h 

vertices 

register  pointer  to 

TERRAIN  POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

I  Calls  I 

Function 

Where  Described 

print  tri  hdr 

See  Section  2.21.7.15.9. 

I  Called  Bv  I 

Function 

Where  Described 

dump  terrain 

See  Section  2.21.7.15.4. 

tdb  print  canopy 

See  Section  2.21.7.15.14. 

Table  2.21-188  tdb_print_trlme  Information. 
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2.21.7.15.9  print_trl_hdr 

print_trl_hdr  prints  only  treeline  header  information  for  a  specified  treeline.  By  default  all 
output  is  sent  to  stderr.  tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file. 
The  function  call  is  print_trl_hdr(treeline).  Table  2.21-189  describes  the  parameters  used 
by  this  function. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

treeline 

register  pointer  to 

TREELINE  HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

1  Called  Bv  1 

Function 

Where  Described 

tdb  print  triine 

See  Section  2.21.7.15.8. 

Table  2.21-189  priiit_trl_hdr  Information. 
2.21.7.15.10  tdb_print_tree 


tdb_print_tree  prints  information  for  a  specified  tree.  By  default  all  output  is  sent  to  stderr. 
tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file.  The  function  call  is 
tdb_print_tree(tree).  Table  2.21-190  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

tree 

register  pointer  to 

TREE  DESCRIPTOR 

/si  mnet/co  mmo  n/li  bsrc/libtdb/t 
errain.h 

Internal  Variables 

■  Variable 

Where  Tvpedef  Declared 

int 

Standard  C  type. 

1  Called  Bv  1 

Function 

Where  Described 

dump  terrain 

See  Section  2.21.7.15.4. 

Table  2.21-190  tdb_print_tree  Information. 
2.21.7.15.11  print_grid_locator 


print_grid_locator  prints  information  for  a  specified  grid  locator.  By  default  all  output  is 
sent  to  stderr.  tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file.  The 
function  call  is  print_grid_locator(grid_loc).  Table  2.21-191  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

grid_loc 

_ _ _ 

HWORD 

/simnet/common/include/glob 
al/mass  stdc.h 
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1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

i 

INT  4 

J 

INT  4 

1  Called  By  1 

Function 

Where  Described 

tdb  print  polyqon 

See  Section  2.21.7.15.5. 

tdb  print  edae 

See  Section  2.21.7.15.6. 

print  c  poly 

See  Section  2.21.7.15.16. 

Table  2.21-191  print_grid_locator  Information. 

2.21.7.15.12  tdb_print_db_info 

tdb_print_db_info  prints  information  for  the  db  iirfo  specified.  By  default  all  output  is  sent 
to  stderr.  tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file.  The  function  call 
is  tdb_print_db_info(db_info).  Table  2.21-192  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dbjnfo 

pointer  to  DBJNFORMATION 

/simnet/common/libsrc/libtdb/t 

errain.h 

1  Calls  1 

Function 

Where  Described 

print  statistics 

See  Section  2.21.7.15.18. 

print  terrain  map 

See  Section  2.21.7.15.13. 

P  FEATURE  TREE 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

P  FEATURE  CANOPY 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

P  FEATURE  RELPOLY 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

P  FEATURE  MICRO 

Macro  defined  in  /simneVcommon/libsrc/libtdb/terrain.h. 

Table  2.21-192  tdb_print_db_info  Information. 

2.21.7.15.13  print_terrain_map 

print_terrain_map  prints  information  for  a  specified  map.  By  default  all  output  is  sent  to 
stderr.  tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file.  The  function  call  is 
print_terrain_map(map).  Table  2.21-193  describes  the  parameters  used,  errors  returned 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

map 

pointer  to  TerrainMap 

/simnet/common/libsrc/libtdb/ 

map.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared  1 

1 

int 
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1  Called  By  1 

Function 

Where  Described 

tdb  print  db  info 

See  Section  2.21.7.15.12. 

Table  2.21-193  print_terrain_map  Information. 
2.21.7.15.14  tdb_print_canopy 

tdb_print_canopy  prints  canopy  information.  By  default  all  output  is  sent  to  stderr. 
tdb_set_dumpfUe  allows  you  to  specify  an  alternate  output  file.  The  function  call  is 
tdb_print_canopy(header,  vertices).  Table  2.21-194  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters 

Parameter 

Where  Typedef  Declared  I 

header 

pointer  to  CANOPY_HEADER 

/simnet/common/libsrc/libtdb/t  j 
errain.h 

vertices 

register  pointer  to 

TERRAIN  POINT 

/si  mnetyco  mmon/libs  rc/li  btdb/t 
errain.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

boundary 

register  pointer  to 

TREELINE  HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

polygons 

register  pointer  to 

POLYGON  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

i 

int 

Standard  C  type. 

no  boundaries 

int 

Standard  C  type. 

1  Calls 

Function 

Where  Described 

print  c  hdr 

See  Section  2.21.7.15.15. 

tdb  print  triine 

See  Section  2.21.7.15.8. 

print  c  poly 

See  Section  2.21.7.15.16. 

1  Called  By 

Function 

Where  Described 

dump,  terrain 

See  Section  2.21.7.15.4. 

Table  2.21-194  tdb_print_canopy  Infoimation. 

2.21.7.15.15  print_c_hdr 

print_c_hdr  prints  information  for  a  specified  canopy  header.  By  default  all  output  is  sent 
to  stderr.  tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file.  The  function  call 
is  print_c_hdr(header).  Table  2.21-195  descr  ibes  the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

header 

pointer  to  CANOPY_HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

1,  . . . . - . .  ,  _  _ _ 1 
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1  Called  By  I 

1  Function  1 

Where  Described 

See  Section  2.21.7.15.14. 

Table  2.21-195  print_c_hdr  Information. 


2.21.7.15.16  print_c_poly 

print_c_poly  prints  canopy  polygon  information.  By  default  all  output  is  sent  to  stderr. 
tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file.  The  function  call  is 
print_c_poly(poly,  vertices).  Table  2.21-196  describes  the  parameters  used  and  functions 
called  using  this  f^unction. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

poly 

register  pointer  to 

POLYGON  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

vertices 

register  pointer  to 

TERRAIN  POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

register  INT_4 

/si  mnet/co  m  mo  n/i  nclude/glob 
al/mass  stdc.h 

no_vertices 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Calls  1 

Function 

Where  Described 

print  arid  locator 

See  Section  2.21.7.15.11. 

GET  CANOPY  POLY  NUM 
VERTS 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  CANOPY  POLY  PRIO 
RITY 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  CANOPY  POLY  TYPE 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  CANOPY  POLY  MIN  X 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  CANOPY  POLY  MIN  Y 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  CANOPY  POLY  MIN  Z 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  CANOPY  POLY  MAX 

X 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  CANOPY  POLY  MAX 

Y 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  CANOPY  POLY  MAX 

Z 

Macro  defined  in  /simnet/comnwn/libsrc/libtdb/terrain.h. 

1  Called  Bv  1 

{Function  1 

Where  Described 

See  Section  2.21.7.15.14. 

Table  2.21-196  print_c_poly  Information. 
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2.21.7.15.17  tdb_print_cache_status 


tdb_print_cache_status  prints  current  status  information  for  the  cache.  Output  includes 
whedier  the  cache  is  initialized,  whether  the  cache  is  enabled,  cache  size,  cache  hits,  and 
cache  faults.  By  default  all  output  is  sent  to  stderr.  tdb_set_dumpfile  allows  you  to  specify 
an  alternate  output  file.  The  function  call  is  tdb_print_cache_status().  Table  2.21-197 
describes  the  internal  variables  used  by  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

cachejndex 

register  INT_4 

/simnet/common/include/glob 
at/mass  stdc.h 

Table  2.21-197  tdb_prmt_cache_status  Information. 
2.21.7.15.18  print_statistics 

print_statistics  prints  statistical  information.  By  default  all  output  is  sent  to  stdeir. 
tdb_set_dumpfile  allows  you  to  specify  an  alternate  output  file.  The  function  call  is 
Drint_statistics(stats).  Table  2.21-198  describes  the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

stats 

pointer  to  DB_STATS 

/si  mnet/commo  n/libs  rc/ li  btdb/t 
errain.h 

1  Called  Bv  1 

Function 

Where  Described 

tdb  print  db  info 

See  Section  2.21.7.15.12. 

Table  2.21-198  print_statistics  Information. 

2.21.7.15.19  tdb_get_db_name 

tdb_get_db_name  returns  the  name  of  the  terrain  database  being  used.  The  function  call  is 
tdb_get_db_name(name).  Table  2.21-199  describes  the  parameters  used  by  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

name 

register  pointer  to  char 

Standard  C  type 

Return  Values 

Return  Value 

Type 

Meaning 

name 

pointer  to  char 

Name  of  database. 

Table  2.21-199  tdb_get_db_name  Information. 
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2.21.7.15.20 


tdb_get_db_version 


tdb_get_db_version  returns  the  version  number  of  the  terrain  database  being  used.  The 
function  call  is  tdb_get_db_version().  Table  2.21-200  describes  the  return  value  generated 
by  this  function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

tdb_info.db_header.dbJnfo. 

version 

INT_2 

Database  version. 

Table  2.21-200  tdb_get_db_version  Information. 
2.21.7.15.21  init_object_and_texture_names 

init_object_and_texture_names  initializes  the  list  of  terrain  texture  names  and  terrain  object 
names.  The  function  call  is  init_object_and_texture_names().  Table  2.21-201  describes  the 
internal  variables  used  by  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

reqister  int 

Standard  C  type. 

Called  By 

Function 

Where  Described 

tdb  init  memorv 

See  Section  2.21.7.25.1. 

tdb  inil  cache 

See  Section  2.21.7.27.1. 

Table  2.21-201  init_object_and_texture_names  Information. 


2.21.7.15.22  get_texture_name_list 

get_texture_name_list  returns  the  list  of  terrain  texture  names.  The  function  call  is 
get_texture_name_list().  Table  2.21-202  describes  the  return  value  generated  by  this 
function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

terrain_texture_names 

pointer  to  pointer  to  char 

the  list  of  terrain  texture  names 

Called  By 

Function 

Where  Described 

tdb  thinq  strinq 

See  Section  2.21.7.28.2. 

Table  2.21-202  get_texture_name_list  Information. 
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2.21.7.15.23  get_object_name_list 

get_object_name_list  returns  the  list  of  terrain  object  names.  The  function  call  is 
get_object_name_list().  Table  2.21-203  describes  the  return  value  generated  by  this 
function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

terrain_object_names 

pointer  to  pointer  to  char 

the  list  of  terrain  object  names 

Called  Bv 

Function 

Where  Described 

tdb  thina  strinq 

See  Section  2.21.7.28.2. 

Table  2.21-203  get_object_name_list  Information. 


2.21.7.16  elevation. c 

/simnet/common/libsrc/libtdb/elevation.c 

elevation.c  contains  routines  for  getdng  an  elevation  from  an  (x,y)  coordinate. 

2.21.7.16.1  tdb_shade_get_z 

tdb_shade_get_z  fills  in  the  z  value  with  the  elevation  on  the  terrain  at  the  (x,y)  co«3rdinates, 
returns  the  soil  type  of  the  supporting  polygon,  and  sets  the  appropriate  shade  flag.  The 
routine  prioritizes  polygons  in  order  to  search  through  to  find  which  polygon  includes  the 
specified  point.  If  the  location  is  off  the  terrain  database,  the  z  value  is  set  to  0. 

check_objects  allows  the  user  to  specify  whether  to  check  the  elevation  of  objects  in 
addition  to  terrain  polygons.  If  check  objects  is  set  to  TDB_GROUND_ONLY,  only 
terrain  polygons  are  considered.  If  check  objects  is  TDB_CHECK_OBJECTS,  then 
objects  are  considered  along  with  the  terrain.  In  the  event  that  support  is  an  object, 
SOIL_NA  is  returned. 

The  memory  location  pointed  to  by  shade  Jlag  is  set  to  0  if  the  support  polygon  is  not 
shaded  for  a  given  sun  angle,  and  1  if  it  is.  For  TDB  ,SHADE_NO_SUN,  the  shade  value 
is  always  0. 

tdb_shade_get_z  returns  the  value  - 1  and  sets  the  global  terrain  error  variable  tdb  errno  if  it 
can  not  determine  the  elevation  at  the  given  coordinates.  If  the  location  is  off  the  terrain. 
tdb  errno  is  set  to  TE_0FF_TERRA1N. 

The  function  call  is  tdb_shade_get_z(coord,  check_objects,  sun_angle,  shade_flag).  Table 
2.21-204  describes  the  parameters  used,  errors  returned  and  functions  called  using  this 
function. 
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Parameters 

Parameter 

Where  Typedef  Declared 

coord 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

check  objects 


sun  anole 


shade  fla 


inter  to  int 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Internal  Variables 

Variable 

Where  Typedef  Declared 

objects 

register  pointer  to 

/simnet/common/libsrc/libtdb/t 

OBJECT  DESCRIPTOR 

errain.h 

no_objects 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

support_poly 


gnd_map 


vertices 


polys 


patch_header 


suDDort  found 


atch 


prev_height 


current  soil 


register  INT_4 


pointer  to 

POLYGON  DESCRIPTOR 


pointer  to  GRID_MAP 


pointer  to  TERRAIN_POINT 


pointer  to 

POLYGON  DESCRIPTOR 


pointer  to  PATCH_HEADER 


reqister  pointer  to  char 


register  REAL_8 


/simnet/common/include/glob 
al/mass  stdc.h 


/si  mnet/co  mmo  n/li  bs  rc/li  btdb/t 
errain.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/Common/libsrc/libtdb/t 

errain.h 


Standard  C  t 


Standard  C  type. 


/simnet/common/include/glob 
al/mass  stdc.h 


Standard  C  type. 


Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

current_soil 

int 

Successful  with  no  shade. 

GET_POLY_SOIL(support_p 
oly->ooly  info) 

int 

Successful  with  shade. 

Error  Name 


TE  OFF  TERRAIN 


TE  NO  SUPPORT 


Errors 


Reason  for  Error 


Point  oiven  is  off  terrain  database. 


No  support  polygon  could  be  found  for  an  otherwise 
acceptable  point. 
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i  Calls  1 

Function 

Where  Described 

tdb  aet  terrain 

See  Section  2.21.7.18.1. 

GET  OBJECT  MIN  X 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MIN  Y 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MAX  X 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MAX  Y 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

Object  include 

See  Section  2.21.7.22.2. 

find  support 

See  Section  2.21.7.16.3. 

find  heiqht  on  poly 

See  Section  2.21.7.16.5. 

P  POLY  MORNING  SHADE 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

P  POLY  NOON  SHADE 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

P  POLY  EVENING  SHADE 

Macro  defined  in  /simnet/comnnon/libsrc/libtdb/terrain.h. 

GET  POLY  SOIL 

Macro  defined  in  /simnet/comnwn/libsrc/libtdb/terrain.h. 

Called  By 

Function 

Where  Described 

tdb  aet  z 

See  Section  2.21.7.16.2. 

tracks  set  support  plane 

See  Section  2.21.7.20.2. 

Table  2.21-204  tdb_shade_gct_z  Information. 
2.21.7.16.2  tdb_get_z 


tdb_get_z  fills  in  the  z  value  with  the  elevation  on  the  terrain  at  the  (x,y)  cor>rdinates.  and 
returns  the  soil  type  of  the  supporting  polygon.  If  the  location  is  off  the  terrain  database, 
the  z  value  is  set  to  0. 


checkjobjects  allows  the  user  to  specify  whether  to  check  the  elevation  of  objects  in 
addition  to  terrain  polygons.  If  check  objects  is  set  to  TDB_GROUND_ONLY,  oriiy 
terrain  polygons  are  considered.  If  check  objects  is  TDB_CHECK_OBJECTS,  then 
objects  are  considered  along  with  the  terrain.  In  the  event  that  the  support  is  an  object, 
SOIL_NA  is  returned. 


tdb_get_z  returns  the  value  -1  and  sets  the  global  terrain  error  variable  tdh  errno  if  it  can 
not  determine  the  elevation  at  the  given  coordinates.  If  the  location  is  off  the  lerraii’ 
tdb  errno  is  set  to  TE_OFF_TERRAIN. 


The  function  call  is  idb_gct  _z(coord,  chcck_objccts).  Table  2.21-2().‘>  descnbcs  Uk- 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

coord 

register  pointer  to 

TDB  POINT 

/si  mnet/cc  mmo  n '  libs  rc '  li  btdb  t 
db.h 

check  objects 

int 

Standard  C  type 

Typ 


int 


Variable 

dummy  shade 


Internal  Variables 
e 


Where  Typedef  Declared 

Standard  C  type. _ 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

tdb_shade_get_z(coord, 
check  objects. 
TDB_SHADE_NO_SUN, 
&dummy  shade) 

int 

Successful. 

1  Calls  1 

Function 

Where  Described 

tdb  shade  aet  z 

See  Section  2.21.7.16.1. 

Called  By 

Function 

Where  Described 

tdb  consistent 

See  Section  2.21.7.13.1. 

See  Section  2.21.7.20.2. 

Table  2.21-205  tdb_get_z  Information. 
2.21.7.16.3  find_support 


find_support  determines  if  there  is  a  support  polygon  at  the  given  coordvnziXt.  The 
function  call  is  find_support(support_poly,  coord,  grid_map,  vertices,  polys).  Table  2.21- 
206  describes  the  parameters  us^  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

support _poly 

po'mier  to  pointer  to 

POLYGON  DESCRIPTOR 

/simnet/common/libsrc/)ibtdb/t 

errain.h 

coord 

pointer  to  TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

grid_map 

register  pointer  to  GRID_MAP 

/simnet/common/libsrc/libtdb/t 

errain.h 

vertices 

pointer  to  TERRAIN_POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

polys 

register  pointer  to 

POLYGON  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

_ Internal  Variables  _ 

Variable _ Type _ Where  Typedet  Declared 

grid_number  register  INT_2  /simnet/common/include/glob 

_ al/mass  stdc.h _ 

slan_poly_index  register  INT_4  /simnet/common/include/glob 

_ al/mass  stdc.h _ 

end_poly_index  register  INT_4  /simnet/common/include/glob 

_ al/mass  stdc.h _ 

i  register  INT_4  /simnet/common/include/glob 

_ _ _ al/mass  stdc.h _ 
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1  Return  Values  I 

Return  Value 

Type 

Meaning 

FALSE 

int 

A  support  polygon  exists  at 
point  coord. 

TRUE 

int 

A  support  polygon  does  not 
exist  at  point  coord. 

1  *  Calls  1 

Function 

Where  Described 

qet  grid  number 

See  Section  2.21.7.16.6. 

1  . . . . . 

See  Section  2.21.7.16.4. 

Table  2.21-206  find_support  Information. 


2.21.7.16.4  p_poIy_provides_support 

p_poly_provides_support  determines  whether  the  given  coordinate  is  included  in  the 
specified  polygon,  current _poly.  The  function  call  is 

p_poly_provides_support(current_poly,  coord,  vertices).  Table  2.21-207  describes  the 
parameters  used  and  functions  call^  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

current_poly 

register  pointer  to 

POLYGON  DESCRIPTOR 

/si  mnet/co  mmon/li  bs  rc/li  btdb/t 
errain.h 

coord 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

vertices 

register  pointer  to 

TERRAIN  POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

Variable 


oly  vertices 


polyjnfo 


Internal  Variables 


e 


reoister  pointer  to  HWORD 


POLY  INFO 


Where  Typedef  Declared 


/simnet/common/libsrc/libtdb/t 

errain.h 


Return  Value 


FALSE 


TRUE 


Return  Values 


Type 


int 


Meaning 


The  polygon  does  not  support 
the  Qiven  point. 


The  polygon  supports  the 
qiven  point. 


Calls 

Function 

Where  Described 

GET  POLY  MIN  X 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  POLY  MIN  Y 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h 

GET  POLY  MAX  X 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h 

GET  POLY  MAX  Y 

Macro  defined  in  /simnel/common/libsrc/libtdb/terrain.h 

polygon  include 

See  Section  2.21.7.22.1. 

GET  POLY  NUM  VERTS 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h 
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1  Called  Bv  1 

Function 

Where  Described 

find  support 

See  Section  2.21.7.16.3. 

Table  2.21-207  p_poly_provides_support  Information. 
2.21.7.16.5  find_height_on_poly 

find_height_on_poly  determines  the  elevation  of  the  given  (x,y)  coordinate  on  the  specified 
polygon,  current _poly.  The  routine  calculates  the  elevation  {coord.z)  based  on  the  dot 
product  of  the  vector  \0->coord  and  a  normal  vector  to  the  polygon  equaling  zero.  If  the 
normal  vector  is  0,  -1  is  returned,  signifying  an  error.  If  the  elevation  is  successfully 
calculated,  0  is  returned.  The  function  call  is  find_height_on_poly(current_poly,  coord, 
vertices).  Table  2.21-208  describes  the  parameters  us^,  errors  returned  and  functions 
called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

current_poly 

pointer  to 

POLYGON  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

coord 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

vertices 

pointer  to  TERRAIN_POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

normal_x 

register  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

normal_y 

register  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

normaLz 

register  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

fvO 

register  pointer  to 

TERRAIN  POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

fvl 

register  pointer  to 

TERRAIN  POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

fv2 

register  pointer  to 

TERRAIN  POINT 

/si  mnet/co  mmon/li  bs  rc/li  btdb/t 
errain.h 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

TE_NO_SUPPORT 

No  support  polygon  could  be  found  for  an  othenvise 
acceptable  point. 

Table  2.21-208  find_height_on_poly  Information. 
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2.21.7.16.6  get_gri<I_number 


get_grid_number  returns  the  grid  number  that  the  point  coord  lies  in.  The  function  call  is 
get_grid_number(coord).  Table  2.21-209  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

coord 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

lower_left 

TDB.POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

patch_coord 

TDB_POINT 

/simnet/comnwn/libsrc/libtdb/t 

db.h 

lowerJeftjj 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

patch_coord_p 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

x_dir 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

y_dir 

register  INT_4 

/simnet/comnwn/include/glob 
al/mass  stdc.h 

grid_size 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

patch_size 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

float  patch  size 

register  double 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

x_dir  +  GRIDS_PER_PATCH 

V  dir 

INT_4 

The  grid  number  that  the  point 
coord  lies  in. 

1  Called  By  I 

Function 

Where  Described 

find  support 

See  Section  2.21.7.16.3 

Table  2.21-209  get  grid  number  Information. 


2.21.7.17  error.c 

/simnet/common/libsrcAibtdb/error.c 

error.c  contains  routines  for  handling  terrain  error  condition  codes.  Table  2.2 1-210 
describes  the  variables  used  by  error.c 


I  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

tdb_err  string 

array  of  MAX__ERR_STRING 
char 

Standard  C  type. 

Table  2.21-210  error.c  Variable  Information. 
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2.21.7.17.1  tdb_error 

tdb_error  returns  a  pointer  to  a  shon  error  message  (no  new-line)  describing  the  last  error 
encountered  during  a  call  to  one  of  the  terrain  library  routines.  The  error  number  is  taken 
from  the  external  variable  tdbjerrno  which  is  set  when  errors  occur  but  not  cleared  when 
non-erroneous  calls  are  made.  The  function  call  is  tdb_error().  Table  2.21-21 1  describes 
the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

format 

array  of 

MAX_DB_FORMAT_LENGTH 

char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

tdb err string 

pointer  to  char 

the  error  message 

1  Calls  1 

Function 

Where  Described 

tdb  aet  db  format 

See  Section  2.21.7.31.5. 

1  Called  By  1 

Function 

Where  Described 

tdb  consistent 

See  Section  2.21.7.13.1. 

Table  2.21-211  tdb_error  Information. 

2.21.7.17.2  tdb_p_on_  database 

tdb_p_on_database  determines  whether  the  given  point  p  is  on  the  database.  The  function 
call  is  tdb_p_on_database(p).  Table  2.21-212  describes  the  parameters  used  by  this 
function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

P 

pointer  to  TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

FALSE 

int 

Point  not  on  database. 

TRUE 

int 

Point  on  database. 

Table  2.21-212  tdb_p_on_database  Information. 

2.21.7.18  get_patch.c 

/simnet/common/Iibsrc/libtdb/get_patch.c 

get_patch.c  contains  a  routine  for  retrieving  terrain  patches  from  the  cache  memory. 
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2.21.7.18.1  tdb_get_terrain 

tdb_get_terrain  returns  a  pointer  to  the  patch  which  includes  the  (x,y)  location  point  coord. 
If  the  patch  cannot  be  retrieved,  a  null  pointer  is  returned  and  the  global  terrain  error 
variable  rdb  err/w  is  set.  The  function  call  is  tdb_get_terrain(coord).  Table  2.21-213 
describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters 

Parameter 

Where  Typedef  Declared 

coord 

pointer  to  TDB_POINT 

/simnet/comnnon/libsrc/libtdb/t 

db.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

patchjndex 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  char 

The  patch  cannot  be  retrieved 

terrain_cachejnquire(patchj 

ndex) 

pointer  to  char 

The  patch  including  coord 

terrain_memoryJnquire(patch 

index 

pointer  to  char 

The  patch  including  coord 

1  Errors  1 

Error  Name 

Reason  for  Error 

TE  CACHE  DISABLED 

Tried  to  access  cache  while  it  was  disabled. 

TE  OFF  TERRAIN 

Point  given  is  off  terrain  database. 

1  Calls  1 

Function 

Where  Described 

PATCH  INDEX 

Macro  defined  in  /simnet/common/libsrc/libtdb/tdb.h. 

terrain  cache  inquire 

See  Section  2,21.7.11.1. 

See  Section  2.21.7.25.4. 

1  Called  Bv  1 

Function 

Where  Described 

tdb  dump  terrain 

See  Section  2.21.7.15.3 

tdb  object  count 

See  Section  2.21.7.26.2. 

tdb  nth  object 

See  Section  2.21.7.26.4. 

tdb  close  object 

See  Section  2.21.7.26.6. 

tdb  obstr  object 

See  Section  2.21.7.26.8. 

tdb  trline  count 

See  Section  2.21.7.29.2. 

tdb  nth  Jrline 

See  Section  2.21.7.29.4. 

tdb  close  trline 

See  Section  2.21.7.29.6. 

tdb  tree  count 

See  Section  2.21.7.30.2. 

tdb  nth  tree 

See  Section  2.21.7.30.4. 

tdb  close  tree 

See  Section  2.21.7.30.6. 

Table  2,21-213  tdb  get  terrain  Information. 
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2.21.7.19  gr  loc_nuin.c 

/simnet/common/ribsrc/libtdb/gr_loc_num.c 

gr_loc_num.c  contains  a  routine  for  getting  a  grid  number  from  a  patch. 

2.21.7.19.1  tdb_get_grid_nuinber 

tdb_get_grid_number  returns  a  grid  number,  given  a  point  in  patch  coordinates  and  the 
patch  size.  The  number  return^  has  a  range  from  0  to  NUM_POLY_GRIDS-l,  where 
NUM_POLY_GRIDS  is  NUM_GRIDS_PER_SIDE  squared.  The  function  call  is 
tdb_get_grid_number(point,  patch_size).  Table  2.21-214  describes  the  parameters  used  by 
this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

point 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

patch_size 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

x_dir 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

y_dir 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

grid_size 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Return  Values  1 

{Return  Value 

Type 

Meaning 

INT_2 

Grid  number  of  point. 

Table  2.21-214  tdb_get_grid_number  Information. 
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2.21.7.20  h_to_w.c 

/simnet/common/libsrc/libtdb/h_to_w.c 

h_to_w.c  contains  routines  for  determining  an  appropriate  huU-to-world  matrix.  Table 
2.21-215  describes  the  variables  used  by  h_to_w.c. 


Variable 


rear_wheel 


left_wheel 


right_wheel 


radius_wheel 


support_rear 


support_right 


supportjeft 


Variables 


array  of  3  REALjB 


array  of  3  REALjB 


array  of  3  REALjB 


REAL_8 


array  of  3  REAL_8 


REAL_8 


REAL  8 


current  soil 


lobai  shade 


lobal  sun  anole 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Standard  C  tvoe. 


Standard  C  type. 


Standard  C  type. 


Table  2.21*215  h  to  w.c  Variable  Information. 


2.21.7.20.1  tdb_get_hull_to_worId 

tdb _get_hull_to_world  creates  a  hull-to-world  matrix  which  will  provide  the  proper 
transformation  from  hull  coordinates  to  world  coordinates  for  a  vehicle  on  the  terrain  at  the 
location  point  and  with  the  given  heading  (in  world  coordinate  radians),  hull  to  world  is 
the  input  pointer  to  the  matrix  which  is  filled  out  by  this  routine 

In  case  of  failure,  -1  is  returned  and  the  global  terrain  error  var  iable  tdb  errm  is  set, 
otherwise  0  is  returned.  If  the  failure  is  due  to  the  given  location  being  off  the  terrain 
(tdb  errno  ==  TE_OFF_TERRAIN),  the  hull-to-world  matrix  passed  is  set  to  a  valid 
rotation  matrix  for  level  support  with  the  given  heading  about  the  z-axis. 

The  function  call  is  tdb_get_huIl_to_world(point,  heading,  hull_to_world).  Tabic  2.21- 
216  describes  the  parameters  used,  enrors  returned  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

point 

pointer  to  TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

heading 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

hull_to_world 

matrix  of  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 
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Internal  Variables 

Variable 

Where  Tvpedef  Declared 

coord 

array  of  3  REALjB 

/simnet/common/include/glob 
al/mass  stdc.h 

w  to  h 


u_norm 


temp_norm 


tempo 


tempi 


max_xjimit 


max_yjimit 


min_xjimit 


min_yjimit 


matnx  of  REAL_8 


matrix  of  REAL_8 


array  of  3  REALjB 


array  of  3  REAL_8 


array  of  3  REAL_8 


array  of  3  REAL_8 


array  of  3  REAL_8 


REAL_8 


REAL_8 


REAL_8 


REAL  8 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Return  Value 


-1 


Return  Values 


Type 

Meaning 

int 

Unsuccessful. 

int 

Successful. 

Error  Name 


TE  OFF  TERRAIN 


Errors 


Reason  for  Error 


Point  given  is  off  terrain  database. 


Function 


mat  rot  init 


vec  scale 


vec  mat  mul 


mat  transpose 


tracks  set  suoDort  olane 


vec  cross  orod 


mat  mat  mul 


Calls 


Where  Described 


See  Section  2.6.2.47.1  in 


See  Section  2.6  .2.64.1  in 


See  Section  2.6.2.56.1  in 


See  Section  2.6.2.51.1  in 


See  Section  2.21.7.20.2. 


See  Section  2.6.2.66.1.  in 


See  Section  2.6.2.32.1  in 


the  Vehicles  CSCI. 


the  Vehicles  CSCI. 


the  Vehicles  CSCI. 


the  Vehicles  CSCI. 


the  Vehicles  CSCI. 


the  Vehicles  CSCI. 


Called  B 


Function  Where  Described 


tdb  shade  place  vehicle  See  Section  2.21.7.20.4. 


Table  2.21-216  tdb_get_huII_to_world  Information. 
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2.21.7.20.2  tracks_set_support_plane 

tracks_set_support_plane  computes  the  unit  normal  of  a  support  plane  in  world 
coordinates.  hjo_w  is  the  hull-to-world  matrix  for  the  vehicle,  h_to_o  is  the  hull-to-origin 
vector  for  the  vehicle  and  u  norm  receives  the  resultant  unit  normal.  The  function  call  is 
tracks_set_support_plane(h_to_w,  h_to_o,  u_norm).  Table  2.21-217  describes  the 
parameters  us^  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

h_to_w 

register  matrix  of  REAL_8 

/simnet/common/include/glob 
at/mass  stdc.h 

h_to_o 

register  array  of  REAL_8 

/simnet/comnfK)n/include/glob 
al/mass  stdc.h 

u_norm 

register  array  of  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

I  Calls  I 

Function 

Where  Described 

vec  sub 

See  Section  2.6.2.65.1  in  the  Vehicles  CSCI. 

vec  mat  mul 

See  Section  2.6.2.56.1  in  the  Vehicles  CSCI. 

tdb  qet  z 

See  Section  2.21.7.16.2. 

tdb  shade  qet  z 

See  Section  2.21.7.16.1. 

tracks  calc  unit  normal 

See  Section  2.21.7.20.3. 

I  Called  By  I 

Function 

Where  Described 

tdb  get  hull  to  world 

See  Section  2.21.7.20.1. 

Table  2.21-217  tracks_set_support_pIane  Information. 


2.21.7.20.3  tracks  calc  unit  normal 


tracks_calc_unit_normal  calculates  the  unit  normal  to  a  support  plane  defined  by  three 
points,  pi,  p2  and  p3.  result  receives  the  unit  normal.  This  unit  normal  is  also  passed  to 
the  kinematics  code.  The  function  call  is  tracks_calc_unit_normal(pl,  p2,  p3,  result). 
Table  2.21-218  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

P1 

register  array  of  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

P2 

array  of  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

P3 

array  of  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

result 

register  array  of  REAL  _8 

/simnet/common  indude/giob 
al/mass  stdc.h 
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_  Internal  Variables  _ 

Variable  I  Type  I  Where  Typedef  Declared 

v1  array  of  3  REALjB  /simnet/common/include/glob 

_ al/mass  stdc.h _ 

v2  array  of  3  REALjB  /simnet/common/include/glob 

al/mass  stdc.h 


_ _ Calls _ 

Function  [Where  Described 

vec  sub _ See  Section  2.6.2.65.1  in  the  Vehicles  CSCI. 

vec  cross  prod _ See  Section  2.6.2.66.1  in  the  Vehicles  CSCI. 

vec  normalize_ See  Section  2.6.2.63.1  in  the  Vehicles  CSCI. 


Called  B' 


Function 

Where  Described 

tracks  set  support  plane 

See  Section  2.21.7.20.2. 

Table  2.21-21S  tracks  calc  unit  normal  Information. 


2.21.7.20.4  tdb_shade_place_vehicle 

tdb_shade_place_vehicle  creates  a  hull-to-world  matrix  which  will  provide  the  proper 
transformation  from  hull  coordinates  to  world  coordinates  for  a  vehicle  on  the  terrain  at  the 
location  point  and  with  the  given  heading.  It  determines  the  elevation  at  the  support  point, 
setting  the  z  location  accordngly,  and  returns  the  soil  type  of  the  supporting  polygon.  It 
also  determines  if  the  support  polygon  is  in  shade  for  the  given  sun  angle.  TTie  memory 
location  pointed  to  by  shMeis  set  to  1  if  the  polygon  is  shaded,  0  otherwise,  hulljo  world 
is  the  input  pointer  to  the  matrix  which  is  filled  out  by  this  routine.  In  case  of  failure,  - 1  is 
returned  and  the  global  terrain  error  variable  tdb  errno  is  set.  The  function  call  is 
tdb_shade_place_vehicle(point,  heading,  hull_to_world,  sun_angle,  shade).  Table  2.21- 
219  describes  the  parameters  used  and  functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

point 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

heeding 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

hul!_to_world 

matrix  of  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

sun  angle 

int 

Standard  C  type. 

shade 

pointer  to  int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

normal_x 

register  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

normal_y 

register  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

normal_z 

register  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

I  I 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

current_soil 

int 

Successful 

Calls 

Function 

Where  Described  I 

tdb  Qet  hull  to  world 

See  Section  2.21.7.20.1.  I 

Called  By 

Function 

Where  Described 

tdb  place  vehicle 

See  Section  2.21.7.20.5. 

Table  2.21-219  tdb_shade_place_vehicle  Information. 
2.21.7.20.5  tdb_place_vehicle 

tdb_place_vehicle  creates  a  hull-to-world  matrix  which  will  provide  the  proper 
transformation  from  hull  coordinates  to  world  coordinates  for  a  vehicle  on  the  terrain  at  the 
location  point  and  with  the  given  heading.  It  determines  the  elevation  at  the  support  point, 
setting  the  z  location  accordingly,  and  returns  the  soil  type  of  the  supporting  polygon. 
hull  to  world  is  the  input  pointer  to  the  matrix  which  is  filled  out  by  ^is  routine.  In  case 
of  failure,  -1  is  returned  and  the  global  terrain  error  variable  tdb  errno  is  set.  The  function 
call  is  tdb_place_vehicle(point,  heading,  hull_to_world).  Table  2.21-220  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  ] 

Parameter 

Where  Typedef  Declared 

point 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

heading 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

hull_to_world 

matrix  of  REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dummy  shade 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

tdb_shadej3lace_vehicle(poi 
nt,  heading,  hull  to  world, 
TDB_SHADE_NO_SUN, 
&dummy  shade) 

int 

If  equal  to  the  soil  type,  the 
routine  was  successful; 

If  equal  to  -1 ,  the  routine  was 
unsuccessful 

1  Calls  1 

Function 

Where  Described 

tdb  shade  place  vehicle 

See  Section  2.21.7.20  4. 

Table  2.21-220  tdb  place  vchicic  Information. 
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2.21.7.21  header.c 

/simnet/comITK)n/libs^c/libtdb^eader.c 

header.c  contains  a  routine  for  reading  the  db_header  for  a  terrain  database. 

2.21.7.21.1  tdb_read_header 

tdb_read_header  reads  the  terrain  data  base  db_header.  The  function  call  is 
tdb_read_header(info).  Table  2.21-221  describes  the  parameters  used  and  errors  returned 
by  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

info 

register  pointer  to  TDBJNFO 

/simnet/common/libsrc/libtdb/t 

db.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

1  Errors  I 

Error  Name 

Reason  for  Error 

TE  OPEN  READ 

Open  or  read  on  the  database  failed. 

1  Called  Bv  1 

Function 

Where  Described 

tdb  qet  tdb  info 

See  Section  2.21.7.27.3. 

Table  2.21-221  tdb_read_header  Information. 

2.21.7.22  include.c 

/simnet/common/libsrcAibtdbAnclude.c 

2.21.7.22.1  polygon_include 

polygonjnclude  determines  whether  the  point  pi  is  inside  or  outside  the  given  polygon, 
poly.  The  function  call  is  poIygon_include(poly,  num_verts,  vertices,  pi).  Table  2.21-222 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

poly 

pointer  to 

POLYGON  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

num_verts 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

vertices 

register  pointer  to 

TERRAIN  POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

P1 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

BBN  Systems  and  Technologies 


MCCCSCI 


Variable 


temp_point1 


tempj3oint2 


Internal  Variables 


register  pointer  to 
TERRAIN  POINT 


register  pointer  to 
TERRAIN  POINT 


register  INT_4 


z 

register  float 

dir 

register  INT_4 

V/here  Typedef  Declared 


/simnet/common/libsrc/Hbtdb/t 

errain.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Standard  C  t 


/simnet/common/include/glob 
al/mass  stdc.h 


Return  Value 


OUTSIDE 


INSIDE 


Return  Values 


Meaning _ 


Point  not  included  in  polygon. 


Point  included  in  polygon. 


Function 


V  CROSS 


Calls 


Where  Described 


Macro  defined  in  /simnet/common/libsrc/libtdb/include.c. 


Function 


rovides  suDoort 


Called  B 


Where  Described 


See  Section  2.21.7.16.4. 


Table  2.21-222  polygonjnclude  Information. 

2.21.7.22.2  object_include 

object_include  determines  whether  the  point  pi  is  inside  or  outside  the  given  object.  The 
function  call  is  object_include(object,  pi).  Table  2.21-223  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameter 


object 


Parameters 


e 


pointer  to 

OBJECT  DESCRIPTOR 


register  pointer  to 
TDB  POINT 


Where  Tvoedef  Declared 


/simnet/common/libsrc/libtdb/t 

errain.h 


/si  mnet/co  mmo  n.'li  bs  rc  'i  btdb/t 
db.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

temp_poinfl 

register  pointer  to 

TERRAIN  POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

temp_point2 

register  pointer  to 

TERRAIN  POINT 

/simnet/common/libsrc/libtdb/t 

errain.h 

num  verts 


register  INT_4 


register  float 


register  INT__4 


/simnet/common/includeglofc 
al/mass  stdc.h 


Standard  C  type. 


/simnet/common/ir, elude 'glob 
al'mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 
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1  Return  Values  1 

Return  Value 

Meaning 

OUTSIDE 

int 

Point  not  included  in  oblect. 

INSIDE 

int 

Point  included  in  object 

1  Calls  1 

Function 

Where  Described 

V  CROSS 

Macro  defined  in  /simnet/common/iibsrc/libtdb/include.c. 

Table  2.21-223  objecMnclude  Information. 


2.21.7.23  lock.c 

/simnet/common/libsrc/libtdb/lockx 

lock.c  contains  routines  for  locking  and  unlocking  patches  in  the  cache  so  they  can’t  be 
swapped  out.  Note  that  they  are  removed  if  the  cache  is  disabled. 

2.21.7.23.1  tdblockpatch 

tdb_lock_patch  marks  a  terrain  patch,  specified  by  coord,  as  unpurgeable.  Normally,  a 
patch  runs  the  risk  of  being  purged  any  time  a  new  patch  is  needed.  It  may  therefore  be 
necessary  to  lock  in  patches  to  which  pointers  arc  maintained.  Locked  patches  can  still  be 
removed  from  the  cache  if  the  cache  is  disabled,  leaving  dangling  pointers.  If  the  patch 
requested  is  not  in  the  cache,  -1  is  returned  and  the  global  terrain  error  variable  tdb  errno  is 
set.  Otherwise  0  is  returned.  The  function  call  is  tdb_lock_patch (coord).  Table  2.21-224 
describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 

\  _ 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

coord 

DOinter  to  TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

patchjndex 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

cachejndex 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

I  Errors  I 

Error  Name 

Reason  for  Error 

TE  NOT  IN  CACHE 

Tried  to  lock  a  patch  not  in  the  cache. 

I  Calls  I 

Function 

Where  Described 

PATCH  INDEX 

Macro  defined  in  /simnet/common/libsrc/libtdb/tdb.h. 

Table  2.21-224  tdb_lock_patch  Information. 
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2.21.7.23.2  tdb_unlock_patch 

tdb_unlock_patch  marks  a  previously  locked  terrain  patch,  specified  by  coord,  as 
purgeable.  If  the  patch  requested  is  not  in  the  cache,  -1  is  returned  and  the  global  terrain 
error  variable  tdb  errno  is  set  Otherwise  0  is  returned.  The  function  call  is 
tdb_  .nlock_patch(coord).  Table  2.21-225  describes  the  parameters  used,  errors  returned 
and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

coord 

pointer  to  TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

patchjndex 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

cachejndex 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

I  Errors  I 

Error  Name 

Reason  for  Error 

TE  NOT  IN  CACHE 

Tried  to  unlock  a  patch  not  in  the  cache. 

I  Calls  I 

Function 

Where  Described 

PATCH  INDEX 

Macro  defined  in  /simnet/common/libsrc/libtdb/tdb.h. 

Table  2.21-225  tdb  unlock  patch  Information. 


2.21.7,24  map.c 

/simnet/common/libsrc/libtdb/map.c 


map.c  contains  routines  to  convert  between  military'  and  terrain  coordinates.  Table 
2.21-226  describes  the  variables  used  by  map.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

scale[] 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

Table  2.21-226  map.c  Variable  Information. 
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2.21.7.24.1  tdb_giv_utm_get_xy 

tdb_giv_utm_get_xy  converts  the  UTM  coordinate  string  pointed  to  by  utm  str  to  Cartesian 
coordinates,  and  places  the  results  where  coord  indicates.  A  correctly  formed  UTM 
coordinate  string  consists  of  two  alphabetic  characters,  the  grid  designator,  followed  by  the 
x-direction  digits,  followed  by  the  y-directi  3n  digits.  The  direction  digits  can  contain  2, 3, 
4,  or  5  digits.  The  grid  designator  and  direction  digits  are  separated  from  each  other  by  any 
number  of  non-digits.  For  example:  ES-85-95;  es  *  85000  **  95000.  The  routine  checks 
the  validity  of  the  UTM  coordinates,  converting  the  numeric  portion  to  meters  from  the 
lower-left  comer  of  the  grid  zone.  The  letter  pair  is  matched  to  the  designation  of  a  grid 
zone,  and  the  UTM  coordinate  numbers  are  checked  for  inclusion  within  that  grid  zone. 

The  f^unction  returns  0  upon  successful  completion.  If  an  error  occurs,  -1  is  returned  and 
the  global  terrain  error  variable  tdb  errno  is  set  The  function  call  is 
tdb_giv_utm_get_xy(utm_str,  coord).  Table  2.21-227  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

utm  str 

reaister  pointer  to  char 

Standard  C  type. 

coord 

pointer  to  TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

tdb_map_utm_to_xy(&(tdbJn 
fo.db_header.db_info.mapJn 
to),  utm  str,  coord) 

int 

the  terrain  coordinates  in 
Cartesian  coordinates 

1  Calls  1 

1  Function 

Where  Described 

See  Section  2.21.7.24.2. 

Table  2.21-227  tdb_giv_utm_get_xy  Information. 

2.21.7.24.2  tdb_map_utm_to_xy 

tdb_map_utm_to_xy  converts  from  UTM  to  Cartesian  coordinates,  the  same  as 
tdb_giv_utm_get_xy.  The  mapjnfo  parameter  allows  conversion  for  any  terrain  database 
without  initializing  terrain  caching.  The  function  returns  0  upon  successful  completion.  If 
an  error  occurs,  -1  is  returned  and  the  global  terrain  error  variable  tdb  errno  is  set.  The 
function  call  is  tdb_map_utm_to_xy(map_info,  utm_str,  coord).  Table  2.21-228  describes 
the  parameters  used  and  errors  returned  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

mapjnfo 

register  pointer  to  TerrainMap 

/simnet/common/libsrc/libtdb/ 

map.h 

utm  str 

pointer  to  char 

Standard  C  type. 

coord 

pointer  to  TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

1  1 
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variable 


maxMaoCoordStrin 


Internal  Variables 


e 


register  INT_2 


register  INT_2 


register  pointer  to  GridZone 


INT_2 


LonoPt 


char 


Where  Typedef  Declared 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdb/ 

maoh 


/simnet/comrTX>n/include/glob 
al/mass  stdc.h 


/si  mnet/mcc/i  nclude/lonqpt .  h 


Standard  C  tvoe. 


Return  Value 


-1 


Type 

Meaning 

int 

Unsuccessful. 

int 

Successful. 

Error  Name 


TE  BADF  UTM 


TE  BAD  ALPHA 


TE  OFF  GRID 


Errors 


Reason  for  Error 


Invalid  format  for  UTM  strin 


Not  a  known  arid  zone. 


The  numeric  part  of  a  UTM  string  is  not  in  the  grid  zone 
specified. 


Function 


Called  B 


Where  Described 


See  Section  2.21.7.24.1. 


Table  2.21>228  tdb_map_utm_to_xy  Information. 

2.21.7.24.3  tdb_giv_xy_get_utm 

tdb_giv_xy_get_utm  converts  the  Cartesian  coordinates  given  in  coord  into  UTM 
coordinates,  formats  a  string  based  on  the  precision  and  separator  specified,  and  copies  the 
result  into  utmjtr.  The  precision  indicates  the  number  of  digits  in  each  direction;  hence  an 
8-digit  UTM  coordinate  string  has  a  precision  of  4.  The  separator  is  placed  between  the 
alphabetic  grid  designators  and  the  x-direction  digits,  and  again  between  the  x-direction 
digits  and  the  y-direction  digits.  A  UTM  coordinate  string  with  a  precision  of  3  and  a 
separator  of  -  would  have  the  format  AA-OOO-OOO.  If  separator  is  the  null  character,  no 
separator  will  be  included  in  the  string.  The  function  returns  0  upon  successful 
completion.  If  an  error  occurs,  -1  is  returned  and  the  global  terrain  error  variable  tdh  errno 
is  set.  The  function  call  is  tdb_giv_xy_get_utm(coord,  utm_str,  prec,  separator).  Table 
2.21-229  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

coord 

register  pointer  to 

TDB  POINT 

/si  mnet/commo  n/li  bs  rc/li  btdb/t 
db.h 

utm  sir 

register  pointer  to  char 

Standard  C  type 

prec 

register  INT  4 

/simnet/comnxin  include/giob 
al  mass  stdc.h 

separator 

char 

Standard  C  type 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

tdb_map_xy_to_utm(&(tdbJn 
fo.db_header.db_info.map_in 
fo),  coord,  utm_str,  prec, 
separator) 

INT_4 

If  equal  to  0,  then  operation 
was  successful;  if  equal  to  -1. 
ann  error  is  returned. 

Calls 

Function 

Where  Described 

tdb  map  xy  to  utm 

See  Section  2.21.7.24.4. 

Table  2.21-229  tdb_giv_xy_get_utin  Information. 


2.21.7.24.4  tdb_map_xy_to_utm 

tdb_map_xy_to_utm  converts  from  Cartesian  to  UTM  coordinates,  the  same  as 
tdb_giv_xy_get_utm.  The  map  info  parameter  allows  conversion  for  any  terrain  database 
without  initializing  terrain  caching.  The  function  returns  0  upon  successful  completion.  If 
an  error  occurs,  -1  is  returned  and  the  global  terrain  error  variable  tdb  errno  is  set.  The 
function  call  is  tdb_map_xy_to_utm(map_info,  coord,  utm_str,  prec,  separator).  Table 
2.21-230  describes  the  parameters  used  and  errors  returned  by  this  function. 


Parameter 


mapjnfo 


utm  str 


prec 


seoarator 


Parameters 


pointer  to  TerrainMap 


pointer  to  TDB_POINT 


inter  to  char 


INT  4 


Where  Tvoedef  Declared 


/simnet/common/libsrc/libtdb/ 

map.h 


/simnet/common/libsrc/libtdb/t 

db.h 


Standard  C  type. 


/simnet/common/include/glob 
al/mass  stdc.h 


Standard  C  t 


Variable 


Internal  Variables 


e 


register  INT_2 


register  INT_4 


register  pointer  to  char 


LongPt 


pointer  to  GridZone 


Where  Typedef  Declared 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Standard  C  type. 


/simnet/mcc/include/longpt.h 


/simnet/common/libsrc/libtdb/ 

map.h 


Return  Value 


-1 


Return  Values 


Type 


int 


int 


Meanin 


Unsuccessful. 


Successful. 
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1  Errors  1 

Error  Name 

Reason  for  Error 

TE  NO  GRID  ZONE 

No  grid  zone  know  for  a  given  point. 

1  Called  By  1 

■  Function 

Where  Described 

See  Section  2.21.7.24.3. 

Table  2.21-230  tdb_map_xy_to_utm  Information. 


2.21.7.25  memory.c 

/simnet/common/libsrc/libtdb/metnory.c 

memory.c  contains  routines  for  initializing  and  terminating  the  tdb  terrain  direct  mentory 
access  system. 

2.21.7.25.1  tdb_init_memory 


tdb_init_memory  disables  the  tdb  caching  system  and  enables  the  terrain  data  base  direct 
memory  access  system.  The  function  call  is  tdb_init_memory(pathname).  Table  2.21-231 
describes  the  parameters  used  and  functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

pathname 

register  pointer  to  char 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

Errors 

Error  Name 

Reason  for  Error 

TE  BAD  FORMAT 

Database  has  wrong  format  for  this  version  of  libtdb. 

Calls 

Function 

Where  Described 

tdb  get  tdb  info 

See  Section  2.21.7.27.3. 

tdb  right  format 

See  Section  2.21.7.31.4. 

init_object_and_texture_nam 

es 

See  Section  2.21.7.15.21 

tdb  set  dumpfile 

See  Section  2.21.7.15.1. 

memory  init 

See  Section  2.21.7.25.2, 

tdb  cache  disable 

See  Section  2.21.7.8.2. 

Table  2.21-231  tdb  init  memory  Information. 
2.21.7.25.2  memoryinit 


memory_init  initalizes  and  allocates  the  memory  for  the  tdb  direct  memory  access  system. 
The  function  call  is  mernory_init().  Table  2.21-232  describes  the  internal  variables  useti 
errors  returned  and  functions  called  using  this  function 


1012 


BBN  Systems  and  Technologies 


MCC  CSCI 


Variable 


size  of  indices 


size  of  patches 


Internal  Variables 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Return  Value 


-1 


Return  Values 


Meanin 


Unsuccessful.  Always 
returned  when  SIMBFLY  is 
defined. 


Successful. 


Error  Name 


TE  CACHE  MALLOC 


TE  OPEN  READ 


Function 


tdb  init  memo 


Errors 


Reason  for  Error 


malloc  failed  for  terrain  cache. 


n  or  read  on  the  database  failed. 


Calls 

Function 

Where  Described 

init  patch  indices 

See  Section  2.21.7.10.1. 

Called  B 


Where  Described 


See  Section  2.21.7.25.1. 


Table  2.21-232  memoryjnit  Information. 

2.21.7.25.3  memory_terminate 

memory_temiinate  terminates  the  tdb  direct  memory  access  system,  freeing  the  index  file 
space  and  closing  the  terrain  binary  or  poly  file.  The  function  call  is  memory_terminate(). 
Table  2.21-233  describes  the  internal  variables  used  and  errors  returned  by  this  function. 


Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful.  Always 
returned  when  SIMBFLY  is 
defined. 

Successful. 


Errors 

Error  Name 

Reason  for  Error 

TE  NOT  INITED 

Memory  not  previously  initialized. 

Function 

Where  Described 

tdb  terminate 

See  Section  2.21.7.27.2. 

Table  2.21-233  memory  ^terminate  Information. 
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2.21.7.25.4  terrain_memory_inquire 

terrain_memory_inquire  returns  a  pointer  to  the  terrain  patch  referenced  by  patch  jndex. 
The  function  call  is  terrain_memory_inquire(patch_index).  Table  2.21-234  describes  the 
parameters  used  by  this  function. 


Parameters 


Parameter 


patchjndex 


ID7!I 


e 


INT  4 


Where  Tvoedef  Declared 


/simnet/common/inciude/glob 
al/mass  stdc.h 


Return  Value 


tdb_info.patch_memory  + 
patch_indices[patch_index]  - 
atch  indices 


mi 


Return  Values 


Type 


pointer  to  char 


Meaning 


A  pointer  to  the  terrain  patch 
referenced  by  patchjndex. 


Function 


tdb  oet  terrain 


Called  B 


Where  Described 


See  Section  2.21.7.18.1. 


Table  2.21-234  terrain_memory_inquire  Information. 

2.21.7.26  objects.c 

/simnet/common^bsrc/libtdb/objects.c 

2.21.7.26.1  count  objects__in_patch 

count_objects_in_pa;ch  U  called  to  determine  how  many  objects  are  around  the  location 
bounded  by  the  smaller  of  radius  or  the  path  boundary.  The  routine  checks  one  terrain 
patch.  If  the  area  is  not  obstructed,  0  is  returned.  Otherwise,  the  number  of  obstructing 
objects  is  returned.  The  function  call  is  count_obJects_in_patch(objects,  num_objects, 
location,  radius).  Table  2.21-235  describes  the  parameters  used  and  functions  called  using 
this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

objects 

register  pointer  to 

OBJECT  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

num_objects 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

/si  mnet/co  mmo  n/i  nclude/glob 
al/mass  stdc.h 

Variable 


num  obstacles 


Internal  Variables 


e 


register  INT_4 


register  INT_4 


Where  Typedef  Declared 


/simnet/common/include'glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 
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_  Return  Values _ _ 

Return  Value _ Type _ Meaning _ 

num_obstacles  int  Number  of  obstructing 

  obstacles. 


_ _ Calls _ 

Function  Where  Described 

GET  OBJECT  MIN  X _ Macro  defined  in  /simnet/common/libsrc/libtdb^errain.h. 

GET  OBJECT  MAX  X _ Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MIN  Y _ Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET OBJECT  MAX  Y_ Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Called  B 


Function 

Where  Described 

tdb  object  count 

See  Section  2.21.7.26.2. 

Table  2.21-235  count_objects_in_patch  Information. 


2.21.7.26.2  tdb_object_count 

tdb_object_count  is  called  to  determine  if  the  area  at  the  given  location  with  the  given  radius 
is  obstructed  by  any  objects.  If  the  area  is  not  obstruct^,  0  is  returned.  Otherwise,  the 
number  of  obstructing  objects  is  returned.  If  an  error  occurs,  the  global  terrain  error 
variable  tdb  errno  is  set.  The  function  call  is  tdb_object_count(location,  radius).  Table 
2.21-236  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

patch 

register  pointer  to  char 

Standard  C  type. 

num_obstacles 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

patch_header 

pointer  to  PATCH_HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

objects 

pointer  to 

OBJECT  DESCRIPTOR 

/simnet/common/libsrc/tibtdb/t 

errain.h 

num_objects_inj3atch 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

coord 

TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

start_x 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

start_y 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

bound_x 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

bound_y 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

ps 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

num_obstacles 

int 

Successful.  Number  of 
obstacles. 

Calls 

Function 

Where  Described 

tdb  get  terrain 

See  Section  2.21.7.18.1. 

count,  objects  in  patch 

See  Section  2.21.7.26.1. 

Table  2.21-236  tdb_object_count  Information. 

2.21.7.26.3  get_nth_object_in_patch 

get_nth_object_  in_patch  is  called  to  determine  if  the  patch  at  the  given  locution  with  tlie 
given  radius  contains  the  nth  object,  counting  from  start.  If  it  does,  nth  ohject  will  be  a 
pointer  to  the  OBJECT_DESCRIPTOR,  and  the  function  returns  0.  Otherwise,  nth  objeci 
will  be  null  and  the  function  returns  start  plus  the  number  of  objects  in  the  patch.  The 
function  call  is  get_nth_object_in_patch(objects,  num_objects,  location,  radius,  start,  n. 
nth_object).  Table  2.21-237  describes  the  parameters  used  and  functions  called  using  this 
function. 
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1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

objects 

register  pointer  to 

OBJECT  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

num_objects 

register  INT_4 

/simnet/comrTK)n/include/glob 
al/mass  stdc.h 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

start 

register  INT_4 

/simnet/comrTK>n/include/glob 
al/mass  stdc.h 

n 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

nth_ob]ect 

pointer  to 

OBJECT  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

i 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Return  Values  1 

Return  Value 

Meaning 

start 

int 

0  or  number  of  objects  in 
patch. 

1  Calls  1 

Function 

Where  Described 

GET  OBJECT  MIN  X 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MAX  X 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MIN  Y 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MAX  Y 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

1  Called  By  1 

Function 

Where  Described 

tdb  nth  object 

See  Section  2.21 .7.26.4. 

Table  2.21-237  get_iith_objecMn_patch  Information. 

2.21.7.26.4  tdb_nth_object 

tdb_nth_object  is  called  to  retrieve  the  nth  object  in  the  area  at  the  given  location  with  the 
given  radius.  If  /z  is  greater  than  the  number  of  objects  in  the  area,  a  null  pointer  is  returned 
and  tdb  errno  is  set  to  TE_NO_OBJECT.  If  any  other  error  occurs,  the  function  returns  -1 
and  tdb  errno  is  set  accordingly.  The  function  call  is  tdb_nth_object(location,  radius,  n, 
nth_object).  Table  2.21-238  describes  the  parameters  used,  errors  returned  and  functions 
called  using  this  function. 
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Parameters 

Parameter 

Where  Typedef  Declared 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL.  8 

/simnet/common/include/glob 
al/mass  stdc.h 

n 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

nth_object 

pointer  to 

OBJECT  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

Variable 


atch 


start 


objects 


nu  m_objectsJ  n_patch 


patch_header 


start  X 


start_y 


bound_x 


bound_y 


Internal  Variables 


e 


reoister  pointer  to  char 


register  INT_4 


pointer  to 

OBJECT  DESCRIPTOR 


INT  4 


pointer  to  PATCH_HEADER 


TDB  POINT 


REAL  8 


REAL  8 


REAL  8 


REAL  8 


register  INT_4 


Where  Tvoedef  Declared 


Standard  C  type. 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Return  Value 


-1 


0 


Return  Values 


Type 


int 


int 


Meaning 


Unsuccessful. 


Successful. 


Error  Name 


TE  NO  OBJECT 


Errors 


Reason  for  Error 


A  request  for  an  object  could  not  be  filled. 


Function 


tdb  qet  terrain 


et  nth  object  m  patch 


Calls 


Where  Described 


See  Section  2.21.7.18.1. 


See  Section  2.21.7.26.3. 


Table  2.21-238  fdb_nth_object  Information. 
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2.21.7.26.5  get_cIosest_object_in_patch 

get_closest_object_in_patch  is  called  to  fetch  the  closest  object  in  the  patch,  within  the 
given  radius,  to  the  given  location.  If  found,  the  routine  returns  the  distance  to  the  object 
and  objects  is  made  to  point  to  it  Otherwise,  objects  will  be  null  imd  the  function  returns 
the  original  radius.  The  function  call  is  get_closest_object_in_patch(objects,  num_objects, 
location,  radius,  close_one,  found_one).  Table  2.21-239  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameters 

Parameter 

Where  Tvpedef  Declared 

objects 

register  pointer  to 

OBJECT  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

num_objects 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

close_one 

pointer  to 

OBJECT  DESCRIPTOR 

/simnet/comnx)n/libsrc/libtdb/t 

errain.h 

found  one 


inter  to  char 


Standard  C  tvpe. 


Variable 


min_y 


max_y 


dx_squared 


dy_squared 


old_distance_squared 


new_distance_squared 


Internal  Variables 


e 


register  INT_4 


register  iNT_4 


register  INT_4 


register  INT_4 


register  INT_4 


REAL  8 


REAL  8 


REAL  8 


REAL  8 


REAL  8 


REAL  8 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/comnxjn/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Return  Value 


radius 


Return  Values 


Type _ 


REAL  8 


Meaning 


Distance  to  object  or  original 
radius. 
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Function 


GET  OBJECT  MIN  X 


GET  OBJECT  MIN  Y 


GET  OBJECT  MAX  X 


GET  OBJECT  MAX  Y 


Calls 


Where  Described 


Macro  defined  in  /simnet/common/tibsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 


Macro  defined  in  /simnet/common/libsrc/libtdbderrain.h. 


Called  B 


Function 

Where  Described 

tdb  close  object 

See  Section  2.21.7.26.6. 

Table  2.21-239  get_closest_object_in_patch  Information. 
2.21.7.26.6  tdb_close_object 

tdb_close_object  is  called  to  retrieve  the  closest  object  in  the  area  at  the  given  location  with 
the  given  radius.  If  there  are  no  objects  in  the  area,  closest  one  is  set  to  the  null  pointer,  -1 
is  returned  and  tdb  errno  is  set  to  TE_NO_OBJECr.  Otherwise,  closest  one  is  set  to 
point  to  the  object  and  the  distance  to  the  object  is  returned.  If  any  other  error  occurs,  the 
function  returns  - 1  and  tdb  errno  is  set  accordingly.  The  function  call  is 
tdb_close_object(location,  radius,  closest_one).  Table  2.21-240  describes  the  parameters 
used,  errors  returned  and  Inunctions  called  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

closest_one 

pointer  to 

OBJECT  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

Variable 


atch 


objects 


patch_header 


num_objecls 


coord 


start  X 


stail_y 


bound_x 


bound_y 


found  one 


tmo  found 


Internal  Variables 


e 


reoister  pointer  to  char 


register  pointer  to 
OBJECT  DESCRIPTOR 


pointer  to  PATCH_HEADER 


TDB  POINT 


REAL  8 


REAL  8 


REAL  8 


REAL  8 


register  INT_4 


Where  Tvoedef  Declared 


Standard  C  type. 


/si  mnet/co  mmo  n/li  bs  rc/li  btdb/t 
errain.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/include'giob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdb/t 

db.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include'giob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Standard  C  type. 


Standard  C  type. 
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Return  Value 


radius 


-1 


Return  Values 


Meanin 


Distance  to  ciosest  object. 


Unsuccessful. 


Error  Name 


TE  NO  OBJECT 


Errors 


Reason  for  Error 


A  reauest  for  an  object  could  not  be  filled. 


Function 


tdb  oet  terrain 


et  closest  object  in  patch 


Calls 


Where  Described 


See  Section  2.21.7.18.1. 


See  Section  2.21.7.26.5. 


Function 


Called  B 


Where  Described 


See  Section  2.21.7.28.1. 


Table  2.21-240  tdb_close_object  Information. 

2.21.7.26.7  get_obstr_object_in_patch 

get_obstr_object_in_patch  is  called  to  fetch  the  closest  object  in  the  patch,  with  a  height  of 
at  least  min_height,  which  after  expansion  is  on  the  line  ^m  start  to  end.  If  found,  the 
routine  returns  1  and  result  is  made  to  point  to  it.  Otherwise,  result  will  be  null  and  the 
function  returns  0.  The  function  call  is  get_obstr_object_in_patch(objects,  num_objects, 
start,  end,  min_height,  expansion,  result,  distance_squared).  Table  2.21-241  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 

Type 

Where  Typedef  Declared 

objects 

register  pointer  to 

OBJECT  DESCRIPTOR 

/si  mnet/co  mmon/li  bs  rc/li  btdb/t 
errain.h 

num_objects 

INT_4 

/simnet/common/include/glob 
al/mass  sldc.h 

start 

register  pointer  to 

TDB  POINT 

/si  mnet/commo  n/li  bs  rc/li  btdb/t 
db.h 

end 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

min_height 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

expansion 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

result 

pointer  to 

OBJECT  DESCRIPTOR 

/simnet/comrrxjn/libsrc/libtdb/t 

errain.h 

distance_squared 

pointer  to  REAL_4 

/simnet/common/include/glob 
al/mass  stdc.h 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

' 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

min_x 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

min_y 

register  INT_4 

/simnet/comrTX>nAinclude/glob 
al/mass  stdc.h 

max_x 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

max_y 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

lowerjeft 

TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

upper_right 

TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

found  one 

int 

Standard  C  type. 

tmp_distance_squared 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

Return  Values 

Return  Value 

Type 

Meaning 

1 

int 

Successful. 

0 

int 

Unsuccessful. 

Calls 

Function 

Where  Described 

GET  OBJECT  MIN  X 

Macro  defined  in/simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MIN  Y 

Macro  defined  in/simnet/common/libsrc/libtdb/terrain.h. 

GET  OBJECT  MAX  X 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain  h. 

GET  OBJECT  MAX  Y 

Macro  defined  in  /simnet/common/libsrc/libtdbAerrain.h. 

rectanqle  intersected 

See  Section  2.21.7.26.9. 

object  intersected 

See  Section  2.21.7.26.10. 

Called  By 

Function 

Where  Described 

tdb  obstr  object 

See  Section  2.21.7.26.8. 

Tabic  2.21-241  get  obstr  objecMn  patch  Information. 
2.21.7.26.8  (db_obstr_object 

tdb_obstr_object  is  called  to  retrieve  the  closest  object  on  the  line  from  start  to  end  after 
expansion  with  a  height  of  at  least  min  height.  If  no  such  object  is  found,  object  is  set  to 
the  null  pointer,  -1  is  returned  and  tdb  errno  is  set  to  TE_NO_OBJECT.  Otherwise,  the 
object  pointed  to  by  object  is  set  to  the  object  found  and  0  is  returned.  If  an  error  occurs, 
the  function  returns  -1  and  tdb  errno  is  set  accordingly.  The  function  call  is 
tdb_obstr_object(stan,  end,  min  ..height,  expansion,  object).  Table  2.21-242  describes  the 
parameters  used,  errors  returned  and  functions  called  using  this  function. 
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Parameters 

Parameter 

Type 

Where  Tvpedef  Declared 

start 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

end 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

min_height 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

expansion 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

object 

pointer  to 

OBJECT  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

Variable 


atch 


objects 


tmp_object 


patch_header 


num_objects 


coord 


patchjowerjett 


patch_upper_right 


start_x 


slart_y 


bound_x 


bound_y 


found  one 


tmo  found 


distance_squared 


tmp_distance_squared 


Internal  Variables 


e 


reoister  pointer  to  char 


register  pointer  to 
OBJECT  DESCRIPTOR 


OBJECT_DESCRlPTOR 


pointer  to  PATCH_HEADER 


TDB_POINT 


TDB_POINT 


TDB_POINT 


REAL_8 


REAL_8 


REAL_8 


REAL_8 


register  INT_4 


char 


char 


REAL_4 


REAL  4 


Where  Tvpedef  Declared 


Standard  C  t 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdb/t 

db.h 


/simnet/common/libsrc/libtdb/t 

db.h 


/simnet/common/libsrc/libfdb/f 

db.h 


/simnet/comnfx)n/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Standard  C  type. 


Standard  C  type. 


/simnet/comnxtn/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Return  Value 


Return  Values 


Meaning 


Successful. 


Unsuccessful. 
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Errors 


_ _ Calls _ 

Table  2.21-242  tdb_obstr_object  Information. 
2.21.7.26.9  rectangle_intersected 


Function _ 

rectangle  intersected 

tdb  get  terrain _ 

get  obstr  object  in  patch 


Where  Described 

See  Section  2.21 .7.26.9. 
See  Section  2.21 .7.18.1 . 
See  Section  2.21.7.26.7. 


Error  Name 
TE  NO  OBJECT 


Reason  for  Error _ 

A  reouest  for  an  object  could  not  be  filled. 


rectangle_intersected  checks  to  see  if  a  line  crosses  through  a  rectangle  using  a  Cohen- 
Sutherland  clipper.  It  returns  1  if  intersection  occurs,  0  otherwise.  The  distance  squared 
variable  is  filled  in  with  the  square  of  the  distance  from  the  left-center  of  the  box  to  the 
closest  intersecting  point  if  the  check  distance  flag  is  set  (this  is  useful  for  finding  the 
“closest”  clipped  fine  segment).  The  function  call  is  rectangle_intersected(start,  end, 
lowerjeft,  upper_right,  check_distance,  distance_squared).  Table  2.21-243  descries  the 
parameters  us^  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

start 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

end 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

lowerjeft 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

upper_right 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

check  distance 

unsigned  int 

Standard  C  type. 

distance  sguared 

pointer  to  float 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

outcodel 

register  unsigned  int 

Standard  C  type. 

outcode2 

register  unsigned  int 

Standard  C  type. 

intersected 

unsigned  int 

Standard  C  type. 

dx 

float 

Standard  C  type. 

dv 

float 

Standard  C  type. 

Xl 

float 

Standard  C  type. 

yi 

float 

Standard  C  type. 

x2 

float 

Standard  C  type. 

y2 

float 

Standard  C  type. 

xmin 

float 

Standard  C  type. 

ymin 

float 

Standard  C  type. 

xmax 

float 

Standard  C  type. 

ymax 

float 

Standard  C  type. 

center  y 

float 

Standard  C  type. 

temp  coord 

float 

Standard  C  type. 

tmp  distance  sguared 

float 

Standard  C  type. 

temp  outcode 

int 

Standard  C  type. 
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Table  2.21>243  rectangie^intersected  Information. 
2.21.7.26.10  objecMntersected 

object_intersected  checks  to  see  if  a  line,  expanded  into  a  rectangle  by  expansion,  crosses 
through  an  object.  The  rectangle  is  rotated  so  that  it  is  parallel  to  the  x-axis  and  then  a 
modified  Sutherland-Cohen  is  applied.  This  modified  version  finds  the  distance_  squared 
from  the  original  start  point  to  the  point  of  intersection.  The  distance  to  the  closest  such 
point  is  returned.  The  routine  returns  1  if  intersection  occurs,  0  otherwise.  The  function 
call  is  object_intersected(start,  end,  object,  expansion,  distance_squared).  Table  2.21-244 
describes  the  parameters  used  and  functions  c^led  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

start 

register  pointer  to 

TDB  POINT 

/si  mnet/co  mmo  n/lius  rc/libtdbA 
db.h 

end 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdbA 

db.h 

object 

pointer  to 

OBJECT  DESCRIPTOR 

/simnet/common/libsrc/libtdbA 

errain.h 

expansion 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

distance_squared 

pointer  to  REALMS 

/simnet/common/include/glob 
al/mass  stdc.h 
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Internal  Variables 


Variable 


edqe  intersects 


X  to  orioin 


to  oriain 


sin  theta 


cos  theta 


translated  end  x 


translated  end 


hypotenuse 


tmp  distance  souared 


new_object_verticesI4] 


translated_vertices[4] 


lower  left 


upper_right 


reoister  int 


reoister  int 


int 


float 


float 


float 


float 


float 


float 


float 


float 


TDB_POlNT 


TDB_POINT 


TDB_POINT 


TDB  POINT 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


/simnet/common/libsrc/libtdb/t 

db.h 


/simnet/comrTK)n/libsrc/libtdb/t 

db.h 


/simnet/common/libsrc/libtdb/t 

db.h 


/simnet/common/libsrc/libtdb/t 

db.h 


Return  Values 


Return  Value 


1 


0 


Meaning 


Intersection  occurs. 


Intersection  does  not  occur. 


Function 


rectanqie  intersected 


Caiis 


Where  Described 


See  Section  2.21.7.26.9. 


Function 


et  obstr  object  in  patch 


Called  B 


Where  Described 


See  Section  2.21 .7.26.7. 


Table  2.21-244  objecMntersected  Information. 

2.21.7.27  tdbinit.c 

/simnei/common/libsrc/libtdb/tdb_.init.c 

tdb_init.c  contains  routines  for  initializing  and  temiinating  tlie  tdb  terrain  caching  system. 

2.21.7.27.1  tdb_init_cache 

tdb_init_cache  initializes  the  terrain  caching  system.  It  opens  the  database  file  specified, 
reads  the  database  indices  and  header,  initializes  the  tdb_info  structure,  and  allocates  and 
locks  in  enough  space  to  cache  up  to  the  number  of  patches  given.  Tlie  function  returns  - 
and  the  global  terrain  error  variable  tdh  errno  is  appropriately  set  if  initialization  fails  for 
any  reason.  Otherwise,  0  is  returned.  The  function  cdl  is  tdb_init_cache(pathnamc. 
number_of_patches_in_cache).  Tabic  2.21-245  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function 


1026 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Parameters  I 

Parameter 

Where  Typedef  Deciared 

pathname 

reqister  pointer  to  char 

Standard  C  type. 

number_ofj3atches_in_cach 

e 

INT_4 

/simnet/common/include/giob 
al/mass  stdc.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful. 

I  Errors  I 

Error  Name 

Reason  for  Error 

TE  BAD  FORMAT 

Database  has  wronq  format  for  this  version  of  tibtdb. 

I  Calls  I 

Function 

Where  Described 

tdb  oet  tdb  info 

See  Section  2.21.7.27.3. 

tdb  riqht  format 

See  Section  2.21 .7.31 .4. 

i  nit_object_and_textu  re_nam 
es 

See  Section  2.21.7.15.21. 

tdb  set  dumpfile 

See  Section  2.21.7.15.1. 

cache  init 

See  Section  2.21.7.7.1. 

Table  2.21-245  tdbjnit_cache  Information. 

2.21.7.27.2  tdb_terminate 

tdb_terminate  terminates  the  d?ta  base  access  system  (either  the  cache  system  or  direct 
memory  access  system),  frees  up  the  data  retrieval  space,  and  closes  all  relevant  files.  The 
function  call  is  tdb_terminate().  Table  2.21-246  describes  the  functions  called  using  this 
function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

cache_and_file_terminate{) 

int 

Terminate  the  cache  system. 

memory_terminate() 

int 

Terminate  the  direct  memory 
access  system. 

Calls 

Function 

Where  Described 

cache  and  file  terminate 

See  Section  2.21.7.7.2. 

memory  terminate 

See  Section  2.21.7.25.3. 

Table  2.21-246  tdb  terminate  Information 
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2.21.7.27.3  tdb_getJdb_info 


tdb_get_tdb_info  gets  information  about  the  data  base  from  the  data  base  header  and  file 
stat  size.  The  function  call  is  tdb_get_tdb_info(pathname,  info).  Table  2.21-247  describes 
the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pathname 

reoister  pointer  to  char 

Standard  C  type. 

info 

register  pointer  to  TDBJNFO 

/simnet/common/libsrc/libtdb/t 

db.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

file  stat 

struct  stat 

Standard  C  type. 

Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful. 

0 

int 

Successful 

Errors  I 

Error  Name 

Reason  for  Error 

TE  OPEN  READ 

Open  or  read  on  the  database  failed. 

Calls  I 

Function 

Where  Described 

tdb  read  header 

See  Section  2.21.7.21.1. 

fstat 

Called  Bv  I 

Function 

Where  Described 

tdb  init  memory 

See  Section  2.21.7.25.1. 

tdb  init  cache 

See  Section  2.21.7.27.1. 

Table  2.21-247  tdb_get_tdb_info  Information. 

2.21.7.28  things.c 

/simnet/common/libsrc/libtdb/things.c 


things.c  contains  routines  for  retrieving  a  copy  of  the  closest  thing  (object,  tree,  or  treeline  ) 
in  a  patch. 

2.21.7.28.1  tdb_close_thing 

tdb_close_thing  determines  if  the  patch  at  the  given  location  within  the  given  radius 
contains  an  object,  tree,  or  treeline.  If  it  does,  thing  will  become  a  pointer  to  the  closest 
thing  found  and  the  function  returns  the  distance  to  it.  Flags  specifies  which  of  the  three 
types  of  things  is  to  be  considered,  either  singly  or  combined.  The  function  returns  -  i  if  an 
error  occurs  or  if  nothing  is  located.  If  an  error  occurs,  the  global  terrain  error  variable 
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tdb  errno  is  set.  The  function  call  is  tdb_close_thing(coord,  radius,  thing,  flags).  Table 
2.21-248  describes  the  parameters  used,  errors  returned  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

coord 

pointer  to  TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

thing 

pointer  to  TDB_THING 

/simnet/common/libsrc/libtdb/t 

db.h 

flaos 

unsioned  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

tmp_di  stance 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

distance 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

object 

OBJECT_DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

tree 

TREE_DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

treeline 

TREELINE_HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

INT_4 

Unsuccessful. 

distance 

INT 4 

Distance  to  thing. 

1  Errors  1 

Error  Name 

Reason  for  Error 

TE  NO  THING 

A  request  for  a  thinq  could  not  be  filled. 

1  Calls  1 

Function 

Where  Described 

tdb  close  object 

See  Section  2.21.7.26.6. 

tdb  close  tree 

See  Section  2.21 .7.30.6. 

tdb  close  triine 

See  Section  2.21.7.29.6. 

Table  2.21-248  tdb_close_thing  Information. 
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2.21.7.28.2  tdb_thing_string 

tdb_thing_string  returns  the  name  string  of  thing,  which  is  either  an  object,  tree,  treeline,  or 
canopy.  The  function  call  is  tdb_thing_string(thing,  string,  string_len).  Table  2.21-249 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

thing 

pointer  to  TDB_THING 

/simnet/common/libsrc/libtdb/t 

db.h 

strina 

Dointerto  char 

Standard  C  type. 

string  len 

int 

Standard  C  type. 

Internal  Variables 

■  Variable  I 

Type 

Where  Typedef  Declared 

int 

Standard  C  type. 

objs 

pointer  to  pointer  to  char 

Standard  C  type. 

tex 

pointer  to  pointer  to  char 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

string 

pointer  to  char 

The  name  string  of  thing. 

1  Calls  1 

Function 

Where  Described 

qet  object  name  list 

See  Section  2.21.7.15.23. 

GET  OBJECT  TYPE 

Macro  defined  in  /simnet/common/libsrc/libtdb/terrain.h. 

qet  texture  name  list 

See  Section  2.21.7.15.22. 

Table  2.21>249  tdb_thing_stnng  Information. 


2.21.7.29  treelines. c 

/simnet/libsrc/libtdb/treelines.c 

2.21.7.29.1  count_treelines_in_patch 

count_treelines  Jn_patch  is  called  to  determine  if  the  area  at  the  given  location  with  the 
given  radius  is  obstructed  by  any  treelines  in  the  given  patch.  If  the  area  is  not  obstructed. 
0  is  returned.  Otherwise,  the  number  of  obstructing  treelines  is  returned.  The  function  call 
is  count_treelines_in_patch(treelines,  num_treelines,  location,  radius).  Table  2  21-250 
describes  the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

treelines 

register  pointer  to 

TREELINE  HEADER 

/si  mnet/co  mmon^li  bs  rc'li  btdb.l 
errain.h 

numjreelines 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL  8 
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variable 


num  obstacles 


vertices 


Internal  Variables 


register  INT_4 


register  INT_4 


register  pointer  to 
TERRAIN  POINT 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/mass  stdc.h 


/simhet/common/include/glob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


Return  Values 


Return  Value 


num  obstacles 


Meanin 


Number  of  obstructing 
treelines. 


Called  B 


Function 

Where  Described 

tdb  triine  count 

See  Section  2.21.7.29.2. 

Table  2.21«250  count_treelines_in_patch  Information. 
2.21.7.29.2  tdb_trline_count 

tdb_trline_count  is  called  to  determine  if  the  area  at  the  given  location  with  the  given  radius 
is  obstructed  by  any  treelines.  If  the  area  is  not  obstructed,  0  is  returned.  Otherwise,  the 
number  of  obstructing  treelines  is  returned.  If  an  error  occurs,  •  1  is  returned  and  the  global 
terrain  error  variable  tdb  errno  is  set.  The  function  call  is  tdb_trline_count(location, 
radius).  Table  2.21-251  describes  the  parameters  used  and  functions  called  using  this 
function. 


Internal  Variables 


Variable 

Type 

Where  Typedef  Declared 

patch 

reaister  pointer  to  char 

Standard  C  type. 

num_obstacles 

register  INT_4 

/simnet/comnfK>n/include/glob 
al/mass  stdc.h 

patch_header 

pointer  to  PATCH_HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

treelines 

pointer  to 

TREELINE  HEADER 

/simnet/comnf)on/libsrc/libtdb/t 

errain.h 

num_treelinesjn_patch 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

coord 

TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

start_x 

REAL_8 

/simnet/comnfK>n/include/glob 
al/mass  stdc.h 

start_y 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

bound_x 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

bound_y 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

ps 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Return  Values  1 

Return  Value 

Meaning 

-1 

int 

Unsuccessful. 

num_obstacles 

int 

Number  of  obstmcting 
treelines. 

I  Calls  I 

Function 

Where  Described 

tdb  qet  terrain 

See  Section  2.21.7.18.1. 

count  treelines  in  patch 

See  Section  2.21.7.29.1. 

Table  2.21-251  tdb  triine  count  Information. 


2.21.7.29.3  get_nth_treeline_in_patch 

get_nth_treeline_in_patch  is  called  to  determine  if  the  patch  at  the  given  location  with  the 
given  radius  contains  the  nrii  treeline,  counting  from  start.  If  it  does,  nth  treeline  will  be  a 
pointer  to  the  TREELINE_HEADER  and  the  function  returns  0.  C)then\'ise,  nth  jreeline 
will  be  null  and  the  function  returns  start  plus  the  number  of  treelines  in  the  patch.  The 
function  call  is  get_nth_treeline_in_patch(treelines,  num_treelines,  location,  radius,  atan, 
n,  nth_treeline).  Table  2.21-252  describes  the  parameters  used  by  this  function. 
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Parameters 

Parameter 

Type 

Where  Typedef  Declared 

treelines 

register  pointer  to 

TREELINE  HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

num_treelines 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

start 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

n 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

nth_treeline 

pointer  to 

TREELINE  HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

Variable 


vertices 


Internal  Variables 


e 


register  INT_4 


register  pointer  to 
TERRAIN  POINT 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


Return  Value 


start 


Return  Values 


Type 


int 


Meanin 


Number  of  treelines  in  patch. 


Called  B 


Function 

Where  Described 

tdb  nth  triine 

See  Section  2.21.7.29.4. 

Table  2.21*252  get_nth_treeline_in_patch  Information. 
2.21.7.29.4  tdb  nth  triine 


tdb_nth_trline  is  called  to  retrieve  the  nth  treeline  in  the  area  at  the  given  location  with  the 
given  radius.  If  n  is  greater  than  the  number  of  treelines  in  the  area,  a  null  pointer  is 
returned  and  tdbjerrno  is  set  to  TE_NO_TREELINE.  If  any  other  error  occurs,  the 
function  returns  -1  and  tdb  errno  is  set  accordingly.  The  function  call  is 
tdb_nth_trline(location,  radius,  n,  nth_treeline).  Table  2.21-253  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

location 

register  pointer  to 

TDB  POINT 

/simnet/comnfX)n/libsrc/libtdb/t 

db.h 

radius 

REALS 

/simnet/common/include/glob 
al/mass  stdc.h 

n 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

nthjreeline 

pointer  to 

TREELINE  HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 
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Variable 


atch 


start 


treelines 


num_treelinesjn_patch 


patch_header 


coord 


start  X 


start_y 


bound_x 


bound_y 


Internal  Variables 


e 


reoister  pointer  to  char 


register  INT_4 


pointer  to 

TREELINE  HEADER 


INT  4 


pointer  to  PATCH_HEADER 


TDB  POINT 


REAL_8 


REAL  8 


REAL  8 


REAL  8 


register  INT_4 


Where  Tvpedef  Declared 


Standard  C  t 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/iibsrc/libtdb/t 

db.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Return  Value 


Return  Values 


Meanin 


Unsuccessful. 


Successful. 


Error  Name 


TE  NO  TREELINE 


Errors 


Reason  for  Error 


A  request  for  a  treeiine  could  not  be  filled. 


Function 


tdb  qet  terrain 


et  nth  treeiine  in  patch 


Calls 


Where  Described 


See  Section  2.21.7.18.1. 


See  Section  2.21.7.29.3. 


Table  2.21-253  tdb_iith_trline  Information. 

2.21.7.29.5  get_closest_treeline_in_patch 

get_closest_treeline_in_patch  is  called  to  fetch  the  closest  treeiine  in  the  patch,  within  the 
given  radius,  to  the  given  location.  If  found,  the  routine  returns  the  distance  to  the  treeiine 
and  treelines  is  made  to  point  to  it.  Otherwise,  treelines  will  be  null  and  the  function 
returns  the  original  radius.  The  function  call  is  get_closest_treeline_in_patch(treelines, 
num_treelines,  location,  radius,  close_one,  found_one).  Table  2.21-254  describes  the 
parameters  used  by  this  function. 
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1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

treelines 

register  pointer  to 

TREELINE  HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

numjreelines 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

RE^L_8 

/simnet/common/include/glob 
al/mass  stdc.h 

close_one 

pointer  to 

TREELINE  HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

found  one 

pointer  to  char 

Standard  C  type. 

Variable 


min_y 


max_x 


max_y 


dx 


dy 


dx_squared 


dy_squared 


tmp_distance_squored 


old_distance_squared 


new_distance_squared 


vertices 


Internal  Variables 


register  INT_4 


register  INT_4 


register  iNT_4 


register  INT_4 


register  INT_4 


register  INT_4 


BEAL_8 


hEAL_8 


REAL_8 


REAL_8 


REAL_8 


REAL_8 


REAL_8 


register  pointer  to 
TERRAIN  POINT 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/SI  mnet/common/i  nclude/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdbA 

errain.h 


Return  Value 


rad-j.' 


Return  Values 


Type 


REAL  8 


Meaning 


Distance  to  treeline 


Function 


tdb  close  triine 


Called  B 


Where  Described 


See  Section  2.21.7.29.6. 


Table  2.21-254  get_cIosest_treeline_in_patch  Information. 
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2.21.7.29.6  tdb  close  triine 


tdb_close_trline  is  called  to  retrieve  the  closest  treeline  in  the  area  at  the  given  location  with 
the  given  radius.  If  there  are  no  treelines  in  the  area,  closest  one  is  set  to  the  null  pointer, 

-1  is  returned  and  tdb  errno  is  set  to  TE_NO_TREELINE.  Otherwise,  closest  one  is  set  to 
point  to  the  treeline  and  the  distance  to  the  treeline  is  returned.  If  any  other  error  occurs, 
the  function  returns  -1  and  tdb  errno  is  set  accwdingly.  The  function  call  is 
tdb_close_trlineOocation,  radius,  closest_one).  Table  2.21-255  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

ysimnet/common/include/glob 
al/mass  stdc.h 

closest_one 

pointer  to 

TREELINE  HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

patch 

reoister  pointer  to  char 

Standard  C  type. 

treelines 

register  pointer  to 

TREELINE  HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

patch_header 

pointer  to  PATCH_HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

nuni_treelines 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

coord 

TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

start_x 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

s<art_y 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

bound_x 

REAL_8 

/simnet/common/include/glob 
al.'mass  stdc.h 

bound_y 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

ps 

register  INT_4 

/simnet/common/include'glob 
al/mass  stdc.h 

found  one 

char 

Standard  C  type 

tmp  found 

char 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

radius 

inf 

Distance  to  treeline 

-1 

int 

Unsuccesstul. 

I  Errors  I 

Error  Name 

Reason  for  Error 

TE  NO  TREELINE 

A  request  for  a  treeline  could  not  be  filled 

I  I 
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1  Calls  1 

Function 

Where  Described 

tdb  aet  terrain 

See  Section  2.21.7.18.1. 

get  closest  treeline  in _patc 
h 

See  Section  2.21 .7.29.5. 

Called  By 

Function 

Where  Described 

tdb  close  thing 

See  Section  2.21.7.28.1. 

Table  2.21-255  tdb_close_trline  Information. 

2.21.7.30  trees.c 

/simnet/common/libsrc/libtdb/trees.c 

2.21.7.30.1  count_trees_in_patch 

count_trees_in_patch  is  called  to  determine  if  the  area  at  the  given  location  with  the  given 
radius  is  obstructed  by  any  trees  in  the  given  patch.  If  the  area  is  not  obstructed  0  is 
returned.  Otherwise,  the  number  of  obstructing  trees  is  returned.  The  function  call  is 
count_trees_in_patch(trees,  num_trees,  location,  radius).  Table  2.21-256  describes  the 
parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

trees 

register  pointer  to 

TREE  DESCRIPTOR 

/simnet/common/libsrc/libtdbA 

errain.h 

numjrees 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

location 

register  pointer  to 

TDB  POINT 

/si  mn  et/co  mmo  n/l  i  bs  rc/ li  btdb/t 
db.h 

radius 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

num_obstacles 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

num obstacles 

int 

Number  of  obstructing  trees. 

1  Called  By  1 

Function 

Where  Described 

tdb  tree  count 

See  Section  2.21.7.30.2. 

Table  2.21-256  count_trees_in_patch  Information. 
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2.21.7.30.2  tdb_tree_count 

tdb_tree_count  is  called  to  deteimine  if  the  area  at  the  given  location  with  the  given  radius  is 
obstructd  by  any  trees.  If  the  area  is  not  obstructed  0  is  returned.  Otherwise,  the  number 
of  obstmcting  trees  is  returned.  If  an  error  occurs,  the  function  returns  -1  and  sets  the 
global  terrain  error  variable.  The  function  call  is  tdb_tree_count(location,  radius).  Table 
2.21-257  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

patch 

register  pointer  to  char 

Standard  C  type. 

num_obstacles 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

patch_header 

pointer  to  PATCH_HEADER 

/simnet/common/libsrc/libtdb/t 

errain.h 

trees 

pointer  to 

TREE  DESCRIPTOR 

/simnet/common/iibsrc/libtdb/t 

errain.h 

num_treesjnj3atch 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

coord 

TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

start_x 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

start_y 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

bound_x 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

bound_y 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

ps 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccesstul. 

num_obstacles 

int 

Number  of  obstructing  trees. 

I  Calls  I 

Function 

vyhere  Described 

tdb  aet  terrain 

See  Section  2.21.7.18.1. 

count  trees  in  patch 

See  Section  2.21.7.30.1. 

Table  2.21-257  tdb  tree  count  Information. 
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2.21.7.30.3  get_nth_tree_ln_patch 

get_nth_tree_in_patch  is  called  to  determine  if  the  patch  at  the  given  location  with  the  given 
radius  contains  the  nth  tree,  counting  from  start.  IJF  it  does,  nth  tree  will  be  a  pointer  to  the 
TREE_DESCRIPTOR  and  the  function  returns  0.  Otherwise,  nth  tree  wil  be  null  and  the 
function  returns  start  plus  the  number  of  trees  in  the  patch.  The  function  call  is 
get_nth_tree_in_patch(trees,  num_trees,  location,  radius,  start,  n,  nth_tree).  Table 
2.21-258  describes  the  parameters  used  by  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

trees 

register  pointer  to 

TREE  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

num_trees 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

start 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

n 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

nthjree 

pointer  to 

TREE  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  INT_4 

/simnet/co  m  mo  n/i  nclude/glob 
al/mass  stdc.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

start 

int 

Number  of  trees  in  patch  or 
the  nth  tree. 

1  Called  By  1 

Function 

Where  Described 

tdb  nth  tree 

See  Section  2.21.7.30.4. 

Table  2.21-258  get_nth_tree_in_patch  Information. 
2.21.7.30.4  tdb_nth_tree 

tdb_nth_tree  is  called  to  retrieve  the  nth  tree  in  the  area  at  the  given  location  with  the  given 
radius.  If  n  is  greater  than  the  number  of  trees  in  the  area,  a  null  pointer  is  returned  and 
tdb_errno  is  set  to  TE_NO_TREE.  If  any  other  error  occurs,  the  function  returns  -1  and 
tdb  errno  is  set  accordingly.  The  function  call  is  tdb_nth_tree(location,  radius,  n, 
nth_tree).  Table  2.21-259  describes  the  parameters  used,  errors  returned  and  functions 
called  using  this  function. 
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Parameters 

Parameter 

Type 

Where  Typedef  Declared 

location 

register  pointer  to 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

n 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

nth_tree 

pointer  to 

TREE  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

Variable 


atch 


start 


num_treesjn__patch 


patch_header 


coord 


start  X 


start_y 


bound_x 


bound_y 


Internal  Variables 


e 


reqister  pointer  to  char 


register  INT_4 


pointer  to 

TREE  DESCRIPTOR 


INT_4 


pointer  to  PATCH_HEADER 


TDB_POINT 


REAL_8 


REAL_8 


REAL  8 


REAL  8 


register  INT_4 


Where  Typedef  Declared 


Standard  C  tvoe. 


/simnet/comnx>nAmclude/giob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnetycommon/include/glob 
al/mass  stdc.h 


/si  mnet/comnx)  n/libs  rc/li  btdb/t 
errain.h 


/simnet/common/libsrc/libtdb/t 

db.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/si  mnet/com  mo  n/i  nclude/glob 
al/mass  stdc.h 


/si  mnet/common/i  nclude/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Return  Value 


Return  Values 


Type 


int 


int 


Meaning 


Successful. 


Unsuccessful. 


Errors 

Error  Name 

Reason  for  Error 

TE  NO  TREE 

A  request  for  a  tree  could  not  be  filled. 

Function 


tdb  aet  terrain 


et  nth  tree  in  patch 


Calls 


Where  Described 


See  Section  2.21.7.18.1. 


See  Section  2.21.7.30.3. 


Table  2.21-259  tdb  nth  tree  Information. 
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2.21.7.30.5  get_closest_tree_in_patch 

get_closest_tree_in_patch  is  called  to  fetch  the  closest  tree  in  the  patch,  within  the  given 
radius,  to  the  given  location.  If  found,  the  routine  returns  the  distance  to  the  tree  and  tree  is 
made  to  point  to  it.  Otherwise,  tree  will  be  null  and  the  function  returns  the  original  radius. 
The  function  call  is  get_closest_tree_in_patch(tree,  num_trees,  locaticm,  radius,  close_one, 
found_one).  Table  2.21-260  describes  the  parameters  used  by  this  function. 


Parameter 


trees 


numjrees 


location 


close  one 


found  one 


Parameters 


register  pointer  to 
TREE  DESCRIPTOR 


INT_4 


register  pointer  to 
TDB  POINT 


REAL_8 


pointer  to 

TREE  DESCRIPTOR 


inter  to  char 


Where  Tvpedef  Declared 


/simnet/common/libsrc/libtdb/t 

errain.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/comrTK>n/libsrc/libtdb/t 

db.h 


/simnet/comnfK>n/include/glob 
al/mass  stdc.h 


/simnet/common/libsrc/libtdb/t 

errain.h 


Standard  C  type. 


Variable 


min_y 


max_y 


dx_squared 


dy_squared 


old_distance_squared 


new_distance_squared 


Internal  Variables 


register  INT_4 


register  REAL_8 


register  REAL_8 


register  REAL_8 


register  REAL_8 


REAL  8 


REAL  8 


REAL  8 


REAL  8 


REAL  8 


REAL  8 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/si  mnet/common/i  nclude/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


/simnet/common/include/glob 
al/mass  stdc.h 


Return  Value 


radius 


Return  Values 


e 


REAL  8 


Meanin 


Original  radius  or  distance  to 
closest  tree. 
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1  Called  By  1 

Function 

Where  Described 

tdb_  close  tree 

See  Section  2.21.7.30.6. 

Table  2.21-260  get_closest_tree_in_patch  Information. 


2.21.7.30.6  tdb_close_tree 

tdb_close_tree  is  called  to  retrieve  the  closest  tree  in  the  area  at  the  given  location  with  the 
given  radius.  If  there  are  no  trees  in  the  area,  closest  one  is  set  to  the  null  pointer,  -1  is 
returned  and  tdb  errno  is  set  to  TE_NO_TREE.  Otherwise,  closest  one  is  set  to  jwint  to 
the  tree  and  the  distance  to  the  tree  is  returned.  If  any  other  error  occurs,  the  function 
returns  -1  and  tdb  errno  is  set  accordingly.  The  function  call  is  tdb_close_treeGocaiton, 
radius,  closest_one).  Table  2.21-261  describes  the  parameters  used,  errors  returned  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

location 

pointer  to  TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

radius 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

closest_one 

pointer  to 

TREE  DESCRIPTOR 

/simnetycommon/libsrc/libtdb/t 

errain.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

patch 

register  pointer  to  char 

Standard  C  type. 

trees 

register  pointer  to 

TREE  DESCRIPTOR 

/simnet/common/libsrc/libtdb/t 

errain.h 

patch_header 

pointer  to  PATCH_HEADER 

/simnet/common/libsrc/libtdbA 

errain.h 

numjrees 

INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

coord 

TDB_POINT 

/si  mnet/co  mmon/libs  rc/li  btdb/t 
db.h 

start_x 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

start_y 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

bound_x 

REAL_8 

/simnet'common/include/glob 
al/mass  stdc.h 

bound_y 

REAL_8 

/simnet/common/include/glob 
al/mass  stdc.h 

ps 

register  INT_4 

/simnet/common/include/glob 
al/mass  stdc.h 

found  one 

char 

Standard  C  type. 

tmp  found 

char 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

radius 

int 

Distance  to  close,st  tree 

-1 

int 

Unsuccessful. 
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1  Errors  1 

Error  Name 

Reason  for  Error 

TE  NO  TREE 

A  request  for  a  tree  could  not  be  filled. 

Calls 

Function 

Where  Described 

tdb  qet  terrain 

See  Section  2.21.7.18.1. 

get  closest  tree  in  patch 

See  Section  2.21.7.30.5. 

Called  Bv 

Function 

Where  Described 

tdb  close  thing 

See  Section  2.21.7.28.1. 

Table  2.21-261  tdb  close  tree  Information. 


2.21.7.31  version.c 

/simnet/common/libsrcAibtdbA'ersion.c 

version.c  contains  routines  for  accessing  the  version  numbers  of  libtdb  and  any  database  it 
accesses  (with  format  >=  v3.01). 


2.21.7.31.1  tdb_print_version 

tdb_print_version  prints  the  terrain  database  version  number.  The  function  call  is 
tdb_print_version().  Table  2.21-262  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

tdb  get  dumpfile 

See  Section  2.21.7.15.2. 

Table  2.21-262  tdb_print_version  Information. 

2.21.7.31.2  tdb_print_format_compatible 

tdb_print_format_compatible  prints  the  database  format  version  number  with  which  this 
version  ov  libtdb  works.  The  function  call  is  tdb_print_format_compatible().  Table  2.21- 
263  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

tdb  get  dumpfile 

See  Section  2.21.7.15.2. 

Table  2.21-263  tdb_print_format_compatible  Information. 
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2.21.7.31.3  tdb_print_db_format 

tdb_print_db_fonnat  prints  the  database  fonnat  name.  The  function  call  is 
tdb_print_db_f(MiTiat().  Table  2.21-264  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

format 

array  of 

MAX_DB_FORMAT_LENGTH 

char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

tdb  aet  dumpfile 

See  Section  2.21.7.15.2. 

tdb  aet  db  format 

See  Section  2.21.7.31.5. 

Table  2.21-264  tdb_print_db_format  Information. 
2.21.7.31.4  tdb_right_format 

tdb_right_format  determines  whether  the  database  format  is  correct.  The  function  call  is 
tdb_right_format().  Table  2.21-265  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


1  Internal  Variables 

Variable 

Where  Typedef  Declared 

dbjormat 

array  of 

MAX_DB_FORMAT_LENGTH 

char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

int 

Not  correct  format. 

TRUE 

int 

Correct  format. 

1  Calls  1 

Function 

Where  Described 

tdb  qel  db  format 

See  Section  2.21.7.31.5, 

Called  Bv 

Function 

Where  Described 

tdb  init  memory 

See  Section  2.21.7.25.1. 

tdb  init  cache 

See  Section  2.21.7.27.1. 

Table  2.21-265  tdb_right_format  Information. 
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2.21.7.31.5  tdb_get_db_format 

tdb_get_db_fonnat  gets  the  database  format.  The  function  call  is 
tdb_get_db_format(buffer).  Table  2.21-266  describes  the  parameters  used  and  errors 
returned  using  this  function. 


Parameters 


Parameter 


buffer 


Variable 


file  desc 


Return  Value 


NULL 


buffer 


Error  Name 


TE  OPEN  READ 


IDl? 
IIS 


inter  to  char 


IBT! 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard  C  t 


Where  Tvoedef  Declared 


Standard  C  t 


Return  Values 


pointer  to  char 


pointer  to  char 


Meanin 


Unsuccessful. 


The  database  fonnat. 


Errors 


Reason  for  Error 


en  or  read  on  the  database  failed. 


ie;; 


Called  B 


Function 

Where  Described 

tdb  error 

See  Section  2.21.7.17.1. 

tdb  print  db  format 

See  Section  2.21.7.31.3. 

tdb  right  format 

See  Section  2.21.7.31.4. 

Table  2.21<266  tdb_get_db_format  Information. 
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2.22  The  Macintosh  Libraries  and  Headers 


Figure  2.21-1:  Macintosh  Libraries. 


2.22.1  libmac 

Folder:  "Development:SIMNET:libmac" 

This  folder  contains  a  library  of  C  functions  shared  among  all  MCC  Macintosh 
applications.  The  library  is  composed  of  the  following  C  source  code  files; 

2.22.1.1  libmac.h 

Development:SIMNET:libmac:libmac.h 

libmac.h  defines  the  interface  to  many  of  the  functions  in  the  libmac  librar>’  Table  2.22-1 
describes  the  variables  used  by  libmac.h. 


1  Variables  1 

Variable 

Tvpe 

Where  Typedef  Declared 

alpSocket 

extern  int 

Standard  C  type. 

hostNode 

extern  int 

Standard  C  type. 

hoslSocket 

extern  int 

Standard  C  type. 

application 

extern  pointer  to  char 

Standard  C  type 

authors 

extern  pointer  to  char 

Standard  C  type. 

mmsmmammm 

extern  pointer  to  char 

Standard  C  type. 

Table  2.22-1  libmac.h  Variable  Information. 

2.22.1.2  draw.h 

Development:SIMNET:libmac;draw.h 


draw.h  defines  constants  that  control  the  proportions  of  displayed  information. 
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2.22.1.3  atalk.c 

Development:SIMNET  :libmac:atalk.c 


atalk.c  contains  routines  supporting  AppleTalk  communication  with  the  MCC  host.  Table 
2.22-2  describes  the  variables  used  by  atalk.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

atpSocket 

short 

Standard  C  type. 

hostNode 

int 

Standard  C  type. 

hostSocket 

int 

Standard  C  type. 

ab 

ABRecHandle 

Development:THINK  C: 

Mac  #includes  Appletalk,  h 

Table  2.22*2  atalk.c  Variable  Information. 

2.22.1.3.1  SetUpAppleTalk 

SetUpAppleTalk  initializes  the  Appletalk  communications  with  the  MCC  host.  The  routine 
returns  a  handle  to  the  network  event  that  starts  up  the  console.  maxRequestSize  is  the 
maximum  number  of  bytes  the  request  will  be.  The  function  call  is 
SetUpAppleTalk(maxRequestSize).  Table  2.22-3  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

maxRequestSize 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

addrRcvd 

AddrBlock 

Development:THINK  C; 

Mac  #includes  Appletalk. h 

i 

int 

Standard  C  type. 

errCode 

int 

Standard  C  type. 

ab 

ABRecHandle 

Development:THINK  C; 

Mac  #includes  Appletalk. h 

entity 

EntityName 

Development:THINK  C: 

Mac  tincludes  Appletalk. h 

hdl 

StringHandle 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

dp 

DialogRr 

Development. THINK  C; 

Mac  #includes;DialOQMqr.h 

which  Dialog 

DialogRr 

DevelopmentrTHINK  C: 

Mac  #includes;DialoqMqr.h 

my  Event 

EventRecord 

Development;THINK  C: 

Mac  #includes:EventMqr.h 

Return  Values 

Return  Value 

Type 

Meaning 

myEvent. message 

Handle 

handle  to  the  network  event 
that  starts  up  the  console 

1  1 
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Function 


ATPLoad 


NBPLoad 


BioProb 


ATPOoenSocket 


SystemFailure 


NewHandle 


HLock 


NewRr 


HUnlock 


ATPGetRequest 


ATPCIoseSocket 


GetStrin 


BlockMove 


DisoosHandle 


NBPReaister 


GetNewDialo 


LastCaution 


SvstemTask 


GetNextEvent 


ExitToShell 


IsDialoqEvent 


DialoaSelect 


DisoosDialo 


Calls 


Where  Described 


letalk  Manaoer  function  for  Macintosh. 


letalk  Manaoer  function  for  Macintosh. 


See  Section  2.22.1.8.2. 


letalk  Manaoer  function  for  Macintosh. 


See  Section  2.22.1.8.1. 


Standard  Memory  Manaoer  function  for  Macintosh. 


Standard  Memory  Manaoer  function  for  Macintosh. 


Standard  Memory  Manaoer  function  for  Macintosh. 


Standard  Memory  Manaoer  function  for  Macintosh. 


letalk  Manaoer  function  for  Macintosh. 


letalk  Manaoer  function  for  Macintosh. 


Standard  Toolbox  Utility  function  for  Macintosh. 


Standard  Memory  Manaoer  function  for  Macintosh. 


Standard  Memory  Manaoer  function  for  Macintosh. 


letalk  Manaoer  function  for  Macintosh. 


Standard  Dialoo  Manaoer  function  for  Macintosh. 


See  Section  2.22.1.4.3. 


Standard  Desk  Manaoer  function  for  Macintosh. 


Standard  Toolbox  Event  Manaoer  function  lor  Macintosh. 


Standard  Seoment  Loader  function  for  Macintosh. 


Standard  Dialoo  Manaoer  function  for  Macintosh. 


Standard  Dialoo  Manaoer  function  for  Macintosh. 


Standard  Dialoo  Manaoer  function  for  Macintosh. 


Table  2.22-3  SetUpAppleTalk  Information. 

2.22.1.3.2  SetUpATPRequest 

SetUpATPRequest  sets  up  the  fields  of  the  ATPRequest  record,  ab  is  the  handle  to  the 
Appletalk  structure;  userData  is  reserved  for  whatever  the  user  wants;  req  is  the  pointer  to 
request  data;  reqSize  is  the  size  of  the  request  data;  rsp  is  the  pointer  to  where  response 
should  go;  rspSize  is  the  maximum  size  of  rsp;  xo  indicates  whether  the  transaction  should 
be  exactly  once  or  at  least  once.  The  function  call  is  SetUpATPRequest(ab,  userData,  req, 
reqSize,  rsp,  rspSize,  xo).  Table  2.22-4  describes  the  parameters  used  by  this  function. 
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1  Called  By  1 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 

DownloadTerrainMap 

See  Section  2.22.1.3.4. 

Table  2.22-4  SetUpATPRequest  Information. 

2.22.1.3.3  ATPPut 

ATPPut  sends  an  ATP  request  and  gets  a  response.  The  function  call  is  ATPPut(code,  req, 
reqSize,  rsp,  RspSize,  xo).  Table  2.22-5  describes  the  parameters  used  and  functions 
called  using  this  function. 


\  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

code 

lonq 

Standard  C  type. 

req 

Rr 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

reqSize 

int 

Standard  C  type. 

rsp 

Rr 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

rspSize 

int 

Standard  C  type. 

xo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

errCode 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Unsuccessful 

(ab)->atpProto.atpActCount 

int 

Actual  size  of  the  response. 

Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manaqer  function  for  Macintosh. 

SetUpATPRequest 

See  Section  2.22.1.3.2. 

ATPRequest 

Standard  Appletalk  Manaqer  function  for  Macintosh. 

ATPError 

See  Section  2.22.1.3.6. 

Table  2.22-5  ATPPut  Information. 

2.22.1.3.4  DownloadTerrainMap 

DownloadTerrainMap  obtains  the  TerrainMap  description  of  the  terrain  mapping  from  the 
host.  The  function  c^l  is  DownloadTerrainMap(userData).  Table  2.22-6  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

userData 

lonq 

Standard  C  type. 

1  1 

1049 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

ab 

register  ABRecHarKile 

Developmenf.THINK  C; 

Mac  #includes;Appletalk.h 

n 

char 

Standard  C  type. 

errCode 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manaqer  function  for  Macintosh. 

SetUpATPRequest 

See  Section  2.22.1.3.2. 

ATPRequest 

Standard  Appletalk  Manaqer  function  for  Macintosh. 

ATPError 

See  Section  2.22.1.3.6. 

DisposHandle 

Standard  Memory  Manaqer  function  for  Macintosh. 

Table  2.22-6  DownloadTerrainMap  Information. 

2.22.1.3.5  NetworkEventHandler 

NetworkEventHandler  fields  a  network  event  signifying  completion  of  an  asynchronous 
AppleTalk  transaction.  theEvent  holds  information  about  the  network  event; 
requestHandler  is  the  pointer  to  the  function  to  call  if  network  event  is  a  request; 
responseHandler  is  a  pointer  to  the  function  to  call  if  this  is  a  response.  The  function  call  is 
NetworkEventHandler( theEvent,  requestHandler,  responseHandler).  Table  2.22-7 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

theEvent 

pointer  to  EventRecord 

DevelopmentTHINK  C; 

Mac  #includes:EventMqr.h 

(requestHandler)!) 

pointer  to  void  function 

Standard  C  type. 

pointer  to  void  function 

Standard  C  type. 

Internal  Variables 

Variable 

EnOHilHHIlilHi 

Where  Typedef  Declared 

ab 

register  ABRecHandle 

Development  THlNK  C: 

Mac  #includes;Appletalk.h 

errCode  I 

int 

Standard  C  type. 

Calls  1 

Function 

Where  Described 

ATPError 

See  Ceci.on  2.22.1  3  6. 

DisposPtr 

Standard  Memory  Manaqer  function  for  Macintosh 

DisposHandle 

Standard  Memory  Manaqer  function  tor  Macintosh. 

AfPGetRequest 

Standard  Appletalk  Manager  function  fc  Macintosh 

Tabic  2.22-7  NetworkEventHandler  Information. 
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2.22.1.3.6  ATPError 


ATPError  inteiprets  an  error  that  occured  with  the  AppleTalk  network.  The  function  call  is 
ATPError(eiTCode).  Table  2.22-8  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

errCode 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

cp 

reaister  pointer  to  char 

Standard  C  type. 

buffi  001 

char 

Standard  C  type. 

Calls 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

Called  Bv 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 

DownloadTerrainMap 

See  Section  2.22.1.3.4. 

NetworkEventHandler 

See  Section  2.22.1.3.5. 

Table  2.22-8  ATPError  Information. 


2.22.1.4  caution.c 

Development:SlMNET:libmac:caution.c 

caution.c  contains  routines  for  displaying  an  alen  box  containing  a  warning  message. 

2.22.1.4.1  ShowCaution 


ShowCaution  puts  up  an  alert  box  with  an  arbitrary  warning  message,  sir.  The  function 
call  is  ShowCaution(str).  Table  2.22-9  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

str 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

d 

Dialog  Ptr 

DevelopmentTHINK  C; 

Mac  #includes;DialogMQr.h 

i 

int 

Standard  C  type. 

theltem 

Handle 

DevelopmentTHINK  C; 

Mac  #includes:MacTypes.h 

box 

Rect 

DevelopmentTHINK  C; 

Mac  #includes:MacTypes.h 

1  1 
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1  Calls  1 

Function 

Where  Described 

SysBeep 

Standard  Operatina  System  Utility  function  for  Macintosh. 

ShowSimpleOialoq 

See  Section  2.22.1.40.1. 

Outlineltem 

See  Section  2.22.1.27.2. 

GetDItem 

Standard  Dialoq  Manaaer  function  for  Macintosh. 

SetIText 

Standard  Dialoq  Manaqer  function  for  Macintosh. 

SetWRefCon 

Standard  Window  Manaqer  function  for  Macintosh. 

ShowWindow 

Standard  Window  Manaqer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

showhelp 

See  Section  2.22.1.19.4. 

setuphtopic 

See  Section  2.22.1.19.16. 

DialoaSeqPrev 

See  Section  2.22.1.39.5. 

CheckLastField 

See  Section  2.22.1.11.5. 

ATPError 

See  Section  2.22.1.3.6. 

Table  2.22-9  ShowCaution  Information. 


2.21.1.4.2  SimpleCautionEvent 


SimpleCautionEvent  is  called  when  a  simple  dialog  gets  an  event.  The  function  call  is 
SimpleCautionEvent( window,  theEvent).  Table  2.22-10  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters 

Parameter 

Type- 

Where  Typedef  Declared 

window 

WindowRr 

DevelopmentTHINK  C: 

Mac  #includes:WindowMqr.h 

theEvent 

pointer  to  EventRecord 

DevelopmentTHINK  C: 

Mac  #includes;EventMqr.h 

internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

itemHit 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

DialoqSelect 

Standard  Dialoq  Manaqer  function  for  Macintosh. 

DisposDialoq 

Standard  Dialoq  Manaqer  function  for  Macinfosh 

SysBeep 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

Table  2.22-10  SimpleCautionEvent  Information. 
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2.21.1.4.3  LastCaution 

LastCaution  returns  a  WindowPtr  pointing  to  the  last  CautionWindow.  If  you  need  to  stick 
your  new  window  behind  the  last  caution  box,  then  call  NewWindow  with  LastCaution. 
The  function  call  is  LastCaution().  Table  2.22-11  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

wPeek 

WindowPeek 

Development:THINK  C: 

Mac  #includes;WindowMgr.h 

fPeek 

WindowPeek 

Development:THINK  C: 

Mac  #includes;WindowMgr.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

WindowRr 

No  caution  boxes  up. 

fPeek 

WindowPtr 

Last  caution  window. 

I  Calls  I 

Function 

Where  Described 

GetWRefCon 

Standard  Window  Manager  function  for  Macintosh. 

I  Called  Bv  I 

I  Function 

Where  Described 

See  Section  2.22.1.11.1. 

ShowSimple  Dialog 

See  Section  2.22.1.40.1. 

SetUpAppleTalk 

See  Section  2.22.1.3.1. 

Table  2.22*11  LastCaution  Information. 

2.22.1.4.4  CountCaution 

CountCaution  returns  the  number  of  caution  boxes  currently  displayed.  The  function  call  is 
CountCaution().  Table  2.22-12  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

wPeek 

WindowPeek 

Development;THINK  C; 

Mac  #includes;WindowMgr.h 

cnt 

int 

Standard  C  tvpe. 

Return  Values 

Return  Value 

Type 

Meaning 

cnt 

int 

Number  of  caution  boxes. 

Calls 

Function 

Where  Described 

GetWRefCon 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.22*12  CountCaution  Information. 
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2.22.1.5  clock. h 

Development:SIMNET:libmac:clock.h 

clock.h  is  the  header  file  associated  with  the  following  file,  clock.c(Section  2.22.1.6). 


2.22.1.6  clock. c 

Development:SIMNET:libniac:clock.c 

clock.c  contains  routines  for  displaying  the  current  date  and  time  in  the  top  right  comer  of 
the  Macintosh  screen.  Table  2.22-13  describes  the  variables  used  by  clock.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

clockPort 

GrafPort 

Development:THINK  C: 

Mac  #includes;Quickdraw.h 

lastMinute 

unsigned  long 

Standard  C  type. 

Table  2.22-13  clock.c  Variable  Information. 
2.22.1.6.1  DrawClock 


DrawClock  writes  the  current  Date  Time  group,  now,  in  the  clock  piort  in  response  to  an 
update.  The  function  call  is  DrawClock(now).  Table  2.22-14  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

now 

unsigned  long 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

tempPort 

GrafRr 

Development:THINK  C: 

Mac  #includes:Quickdraw.h 

dtg 

DateTimeGroup 

DevelopmentiSIMNET  :libmac: 
dtg.h 

strr201 

char 

Standard  C  type. 

Calls 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

Erase  Red 

Standard  Quickdraw  function  for  Macintosh. 

FrameRed 

Standard  Quickdraw  function  for  Macintosh. 

DTG  Elapsed 

See  Section  2.22.1.15.3. 

DTGToString 

See  Section  2.22.1.15.1. 

MoveTo 

Standard  Quickdraw  function  for  Macintosh. 

DrawTexl 

Standard  Quickdraw  function  for  Macintosh. 

1  1 
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_  Called  By _ 

Function  I  Where  Described 

UpdateClock _ See  Section  2.22A.B.2. _ 

RedrawClock _  See  Section  2.22.1  .e.a. _ 

InstallClock _ See  Section  2.22.1  ■6.4. _ - 

SetClock_____^^____  See  Section  2.22.1  .S.S. 

Table  2.22>14  DrawClock  Information. 


2.22.1.6.2  UpdateClock 


UpdateClock  updates  the  clock  every  minute.  The  function  call  is  UpdateClock().  Table 
2.22- IS  descrites  the  internal  variable  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

now 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operatino  System  Utility  function  for  Macintosh. 

DrawClock 

See  Section  2.22.1.6.1. 

Table  2.22-15  UpdateClock  Information. 


2.22.1.6.3  RedrawClock 


RedrawClock  redraws  the  clock  with  the  current  time.  The  function  call  is  RedrawCIock(). 
Table  2.22-16  describes  the  internal  variable  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

now 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operatina  System  Utility  function  for  Macintosh. 

DrawClock 

See  Section  2.22.1.6.1. 

Table  2.22-16  RedrawClock  Information. 


2.22.1.6.4  InstallClock 


InstallClock  sets  up  the  Clock  GrafPort  and  displays  the  current  time.  The  function  call  is 
InstallClock().  Table  2.22-17  describes  the  intern^  variable  used  and  functions  called 
using  this  function. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

tempPort 

GrafRr 

DeyelopmentTHINK  C; 

Mac  #includes:Quickdraw.h 

now 

unsigned  long 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

OpenPort 

Standard  Quickdraw  function  for  Macintosh. 

PortSize 

Standard  Quickdraw  function  for  Macintosh. 

MovePortTo 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

GetDateTime 

Standard  Operatina  System  Utility  function  for  Macintosh. 

DrawClock 

See  Section  2.22.1.6.1. 

Table  2.22-17  InstallClock  Information. 


2.22.1.6.5  SetClock 

SetClock  sets  the  clock  to  the  time  now.  The  function  call  is  SetClock(now).  Table  2.22- 
18  describes  the  internal  variable  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

now 

unsiqned  lonq 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SetDateTime 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

DrawClock 

See  Section  2.22.1.6.1. 

Table  2.22-18  SetClock  Information. 


2.22.1.7  control. c 

Development:  S  IMNET;libmac:control  .c 

control.c  contains  routines  for  enabling  and  disabling  controls  within  dialogs. 

2.22.1.7.1  DisableControl 


DisableControl  disables  a  control  within  a  dialog,  dialog  is  the  dialog  that  control  is  in; 
itemNo  is  the  itemNo  of  the  control.  The  function  call  is  DisableControl(dialog,  itemNo). 
Table  2.22-19  describes  the  parameters  used  and  functions  called  using  this  function 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

dialog 

DialogPir 

DevelopmentiTHINK  C: 

Mac  #includes:DialoqMqr.h 

itemNo 

int 

Standard  C  type 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

theltem 

Handle 

DevekjpmentTHINK  C 

Mac  #includes:MacTypes  h 

box 

Reel 

DevelopmentTHINK  C 

Mac  #includes  MacTypes  h 

1().‘)6 
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1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialoa  Manaoer  function  for  Macintosh. 

HiliteControl 

Standard  Control  Manaoer  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

LabelForceButtons 

See  Section  2.22.1.16.1. 

Table  2.22-19  DisableControl  Information. 


2.22.1.7.2  EnableControl 

EnableControl  enables  a  control  within  a  dialog.  The  function  call  is  EnableControl(dialog, 
itemNo).  Table  2.22-20  describes  the  parameters  used  and  functions  called  using  this 
function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

Dialog  Ptr 

DevelopmentiTHINK  C; 

Mac  #includes:DialogMgr.h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

theltem 

Handle 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

box 

Rect 

Development;THINK  C: 

Mac  #includes:MacTypes.h 

Calls 

Function 

Where  Described 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

HiliteControl 

Standard  Control  Manager  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

LabelForceButtons 

See  Section  2.22.1.16.1. 

Table  2.22-20  .EnableControl  Information. 
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2.22.1.8  bigprob.c 

Development;SIMNET;libmac;bigprob.c 

bigprob.c  contains  routines  for  reporting  unrecoverable  errors. 

2.22.1.8.1  SystemFailure 

SystemFailure  calls  BipProb  with  a  system  error  code.  errCode  is  the  eiror  number  of  type 
of  eiTor,  place  is  a  string  that  describes  where  error  occurred.  The  function  call  is 
SystemFailure(errCode,  place).  Table  2.22-21  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

errCode 

int 

Standard  C  type. 

place 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

str 

array  of  256  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

BigProb 

See  Section  2.22.1.8.2. 

1  Called  Bv  1 

Function 

Where  Described 

SelUpAppleTalk 

See  Section  2.22.1.3.1. 

Table  2.22-21  SystemFailure  Information. 
2.22.1.8.2  BigProb 


BigProb  puts  up  an  alert,  s,  and  halts  the  program.  The  function  call  is  BigProb(s).  Table 
2.22-22  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

ParamText 

Standard  Dialog  Manager  function  for  Macintosh. 

StopAlert 

Standard  Dialog  Manager  function  for  Macintosh. 

ExitToShell 

Standard  Segment  Loader  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

SystemFailure 

See  Section  2.22.1.8.1 . 

SetUpAppleTalk 

See  Section  2.22.1.3.1 . 

Table  2.22-22  BigProb  Information. 
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2.22.1.9  dialog.h 

Development:SIM>feT  :libmac:dialog.h 

dialog.h  is  the  header  file  associated  with  the  following  files,  which  collectively  provide 
support  for  dialog  boxes. 

2.22.1.10  dialine.c 

DevelopmentrSIMNET  :libmac:dialine.c 

dialine.c  contains  routines  for  drawing  lines  and  rectangles  within  dialogs. 

2.22.1.10.1  DrawLine 

DrawLine  draws  a  line  or  a  rectangle  in  a  dialog  box.  The  function  call  is  DrawLine(w, 
itemNo).  Table  2.22-23  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Tvbe 

Where  Typedef  Declared 

w 

register  WindowFIr 

Development  THINK  C; 

Mac  #includes;WindowMgr.h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

i 

int 

Standard  C  type. 

field 

int 

Standard  C  type. 

theltem 

Handle 

DeyelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

r 

Rect 

DeyelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

defn 

register  pointer  to 
LineFieldDefn 

DevelopmentiSIMNET  :libmac; 
dialog.h 

pnState 

PenState 

DeyelopmentTHINK  C: 

Mac  #includes:Quickdraw.h 

CaHs 

Function 

Where  Described 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

OialoaLookupField 

See  Section  2.22.1.12.1. 

Set  Port 

Standard  Ouickdraw  function  for  Macintosh. 

GetPenState 

Standard  Quickdraw  function  for  Macintosh. 

PenSize 

Standard  Quickdraw  function  for  Macintosh. 

PenMode 

Standard  Quickdraw  function  for  Macintosh. 

PenPat 

Standard  Quickdraw  function  for  Macintosh. 

MoveTo 

Standard  Quickdraw  function  for  Macintosh. 

LineTo 

Standard  Quickdraw  function  for  Macintosh. 

FrameRect 

Standard  Quickdraw  function  for  Macintosh. 

SetPenState 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.22-23  DrawLine  Information. 
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2.22.1.11  dialog.c 

Development.SIMhffiTrlibmacrdialog.c 

dialog.c  contains  routines  for  initializing,  discarding  and  checking  the  entries  in  dialogs, 
and  for  handling  events  associated  with  dialogs. 

2.22.1.11.1  ShowDialog 

ShowDialog  is  called  to  display  a  dialog  box.  The  function  call  is  ShowDialog(dStorage, 
defn).  The  function  returns  a  pointer  to  DialogState,  a  structure  defined  in  dialog.h. 
dStorage  is  the  pointer  to  DialogState  structure;  defn  is  the  pointer  to  DialogDefn  structure. 
Table  2.22-24  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


dStorage 


Parameters 


e 


register  Rr 


register  pointer  to  DialogDefn 


Where  Typedef  Declared 


Development:THINK  C: 
Mac  #includes:MacTvDes.h 


DevelopmentiSIMNET  ilibmac; 
dialOQ.h 


Internal  Variables 

Variable 

Where  Typedef  Declared 

fpp 

pointer  to  pointer  to  FieldDefn 

Development:SIMNET;libmac: 

dialOQ.h 

fnc 

pointer  to  function  that  returns 
int 

Standard  C  type. 

theltem 


mt 


int 


Handle 


Standard  C  type. 


Standard  C  tvoe. 


Development:THINK  C; 
Mac  #includes:MacTvpes.h 


Development:THINK  C: 
Mac  #includes:MacTvpes.h 


Return  Value 


STATE 


Return  Values 


Type 


DialogState 


Meaning 


The  specified  dialog 


Function 


NewRr 


GetNewDialo 


LastCaution 


SetWRefCon 


Outlineltem 


ShowFixTable 


ShowScrollTable 


GefDItem 


SetDItem 


Calls 


Where  Described 


Standard  Memory  Manaoer  function  for  Macintosh. 


Standard  Dialoa  Manaoer  function  for  Macintosh. 


See  Section  2.22.1.4.3. 


Standard  Window  Manager  function  for  Macintosh. 


See  Section  2.22.1.27.2. 


See  Section  2.22.1.42.1. 


See  Section  2.22.1.30.1. 


Standard  Dialoa  Manaoer  function  for  Macintosh. 


Standard  Dialoa  Manager  function  for  Macintosh. 


See  Section  2.22.1.11.2. 
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1  Called  Bv  1 

Function 

Where  Described 

ShowDialoaSegNode 

See  Section  2.22.1.39.2. 

Table  2.22-24  ShowDialog  Information. 

2.22.1.11.2  UpdateDialog 

UpdateDialog  loads  values  into  the  editable  fields  of  a  dialog  box  specified  by  dialog.  The 
function  call  is  UpdateDialog(dialog).  Table  2.22-25  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

register  pointer  to  DiatogState 

Development:SIMNET  ilibmac: 
dialog,  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

fpp 

pointer  to  pointer  to  FieldDefn 

Development  ;S  1 M  N  ET.libmac : 
dialog,  h 

field 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

theltem 

Handle 

DevelopmentiTHINK  C; 

Mac  #includes:MacTvoes.h 

box 

Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialoq  Manager  function  for  Macintosh. 

SetCtIValue 

Standard  Control  Manager  function  for  Macintosh. 

SetITexf 

Standard  Dialog  Manager  function  for  Macintosh. 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

DTGToStrina 

See  Section  2.22.1.15.1. 

’  Called  By  I 

'  Function 

Where  Described 

1  ShowDialbq 

See  Section  2.22.1.11.1. 

Table  2.22-25 


UpdateDialog  Information. 
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2.22.1.11.3 


ThrowDialog 


ThrowDialog  removes  a  dialog,  dialog,  from  the  screen.  The  function  call  is 
ThrowDialog(dialog).  Table  2.22-26  describes  the  parameter  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

dialog 

register  pointer  to  DialogState 

OevelopmentiSIMNET  :libmac; 
dialog. h 

1  Calls  1 

Function 

Where  Described 

CloseDialoa 

Standard  Dialog  Manager  function  for  Macintosh. 

DisposHandle 

Standard  Menx)ry  Manager  function  for  Macintosh. 

1  Called  Bv  I 

Function 

Where  Described 

DialooSeoNext 

See  Section  2.22.1.39.4. 

DialoqSeqPrev 

See  Section  2.22.1.39.5. 

Table  2.22-26  ThrowDialog  Information. 
2.22.1.11.4  DialogEvent 


DialogEvent  handles  an  event,  theEvent,  within  a  dialog  box,  specified  by  dialog,  window 
is  the  window  in  which  the  event  occurred;  theEvent  returns  0  if  the  event  was  invalid, 
otherwise  it  returns  the  itemNo  of  the  control  the  event  was  about.  The  function  call  is 
DialogEvent(window,  theEvent).  Table  2.22-27  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

window 

register  WindowRr 

DevelopmentTHINK  C: 

Mac  #includes:WindowMgr.h 

theEvent 

pointer  to  EventRecord 

DevelopmentiTHINK  C: 

Mac  #includes:EventMqr.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

defn 

register  pointer  to  DialogDefn 

OevelopmentiSIMNET  ilibmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

field 

int 

Standard  C  type. 

fpp 

pointer  to  pointer  to  FieldDefn 

OevelopmentiSIMNET  ilibmaci 
dialog. h 

IP 

pointer  to  FieldDefn 

OevelopmentiSIMNET  ilibmaci 
dialog. h 

theltem 

Handle 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTypes.h 

ctl 

ControlHandle 

DevelopmentiTHINK  C’ 

Mac  #includes.ConfrolMqr  h 

ch 

char 

Standard  C  type 
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Return  Values 


Return  Value 


itemNo 


Meanin 


Unsuccessful. 


The  resource  id  of  the  button 
ressed. 


Calls 

Function 

Where  Described 

SubPt 

Standard  Quickdraw  function  for  Macintosh. 

DialoqSelect 

Starxfard  Dialoa  Manaoer  function  for  Macintosh. 

Scroll! able  Activate 

See  Section  2.22.1.32.1. 

DialooLookuoField 

See  Section  2.22.1.12.1. 

CheckLastField 

See  Section  2.22.1.11.5. 

SetRadioButton 

See  Section  2.22.1.11.6. 

SetCheckBox 

See  Section  2.22.1.11.7. 

FixTable  Event 

See  Section  2.22.1.42.3. 

ScrollTableEvent 

See  Section  2.22.1.32.2. 

Called  B 


Function 

Where  Described 

DialoqSeqEvent 

See  Section  2.22.1.39.3. 

2.22.1.11.5 


Table  2.22-27  DialogEvent  Information. 
CheckLastField 


CheckLastField  checks  the  syntax  of  the  field  just  left.  The  function  call  is 
CheckLastField(dialog).  Table  2.22-28  describes  the  parameters  used,  errors  returned  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development;SIMNET  :libmac: 
dialog. h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Ip 

register  pointer  to  FiekJDefn 

Development;SIMNET  ilibmac: 
dialog. h 

i 

int 

Standard  C  type. 

n 

long 

Standard  C  type. 

theltem 

Handle 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

box 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

cp 

pointer  to  char 

Standard  C  type. 

cStr 

pointer  to  char 

Standard  G  type. 

char 

Standaro  C  type. 

map 

MapCoordinates 

Development  :SIM  NET  ilibmac: 
map.h 

dtg 

DateTimeGroup 

DevelopmentiSIMNET  ilibmac; 
dtq.h 
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Function 


GetDItem 


GetIText 


SellText 


ShowCaution 


StringToNum 


St  ri  noToM  aoCoordi  nates 


SetIText 


StrinaToDTG 


Calls 


Where  Described 


Standard  Dialoq  Manaaer  function  for  Macintosh. 


Standard  Dialog  Manager  function  for  Macintosh. 


Standard  Dialog  Manager  function  for  Macintosh. 


See  Section  2.22.1.4.1. 


Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 


See  Section  2.22.1.26.1. 


Standard  Dialog  Manaaer  function  for  Macintosh. 


See  Section  2.22.1.15.2. 


Called  B 


Function 

Where  Described 

Dialog  Event 

See  Section  2.22.1.11.4. 

Table  2.22-28  CheckLastField  Information. 


2.22.1.11.6 


SetRadioButton 


SetRadioButton  sets  a  radio  button  on  and  the  others  in  the  group  off.  The  function  call  is 
SetRadioButton(dialog,  itemNo).  Table  2.22-29  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 

Parameter 

Where  Tvoedef  Declared 

dialog 

pointer  to  DialogState 

Development  :SIMNET  ilibmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Ip 

register  pointer  to 

RBFieldDefn 

Deve!opment:SIMNET  ilibmac: 
dialog. h 

fpp 

pointer  to  pointer  to  FieldDefn 

DevelopmentiSIMNETlibmac; 
dialog. h 

theltem 


int 


Handle 


Standard  C  tvoe. 


DevelopmentiTHINK  C: 
Mac  #includes:MacTvpes.h 


DevelopmentiTHINK  C; 
Mac  #includes:MacTvpes.h 


Function 


DialogLookuoField 


GetDItem 


SetCtiValue 


Calls 


Where  Described 


See  Section  2.22.1.12.1. 


Standard  Dialog  Manaaer  function  for  Macintosh. 


Standard  Control  Manaaer  function  for  Madntosh. 


Called  B 


Function 

Where  Described 

DialogEvent 

SeeSection  2.22.1.11.4. 

Table  2.22-29  SetRadioButton  Information. 
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2.22.1.11.7  SetCheckBox 

SetCheckBox  sets  a  check  box  on  or  off.  dialog  points  to  the  dialog  check  box  is  in; 
itemNo  is  the  itemNo  of  check  box;  value  states  whether  check  box  should  be  turned  on  or 
off.  The  function  call  is  SetCheckBox(dialog,  itemNo,  value).  Table  2.22-30  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development;SIMNET  tlibmac; 
dialog.h 

itemNo 

int 

Standard  C  type. 

value 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

Ip 

pointer  to  CBFieidDeln 

Development:SIMNET  ilibmac: 
dialog.h 

i 

int 

Standard  C  type. 

theltem 

Handle 

DevelopmentTHINK  C: 

Mac  #jncludes;MacTypes.h 

box 

Rect 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

1  Calls  1 

Function 

Where  Described 

DialogLookupField 

See  Section  2.22.1.12.1. 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

SetCtIValue 

Standard  Control  Manager  function  tor  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

Dialog  Event 

See  Section  2.22.1.11.4. 

Table  2.22-30  SetCheckBox  Information. 


2.22.1.11.8  SetText 


SetText  sets  a  text  item  to  a  string.  The  function  call  is  SetText(dialog,  itemNo,  cStr). 
Table  2.22-31  describes  the  parameters  used  and  functions  called  using  this  function. 
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Internal  Variables 


Variable 


theltem 


box 


int 


Handle 


Where  Tvoedef  Declared 


Standard  C  t 


Development;THINK  C: 
.Mac  #includes:MacTypes.h 


Development:THINK  C: 
Mac  #tncludes:MacTvDes.h 


Standard  C  t 


Calls 

Function 

Where  Described 

GetDItem 

Standard  Oialoo  Manager  function  for  Macintosh. 

SetIText 

Standard  Dialog  Manager  function  for  Macintosh. 

Table  2.22-31  SetText  Information. 

2.22.1.12  dialookup.c 

Development:  SIMNET :  libmac:dialookup.c 

dialookup.c  contains  a  routine  for  locating  a  definition  of  a  dialog  field  given  its  dialog  item 
number. 


2.22.1.12.1 


DialogLookupField 


DialogLookupField  locates  a  field  by  item  number.  The  function  call  is 
DialogLookupField(state,  itemNo).  Table  2.22-32  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Tvoedef  Declared 

state 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac. 
dialog. h 

itemNo 

int 

Standard  C  type. 

Variable 


fpp 


Internal  Variables 


e 


Where  Tvoedef  Declared 


pointer  to  pointer  to  FieldDefn  Development:SIMNET;libmac: 


register  int 


dialog. h 


Standard  C  type 


Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

Not  successful. 

Field  definition. 
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1  Called  By  1 

Function 

Where  Described 

DrawLine 

See  Section  2.22.1.10.1. 

DrawFixTable 

See  Section  2.22.1.42.4. 

DialogEvent 

See  Section  2.22.1.11.4. 

SetRadioButton 

See  Section  2.22.1.11.6. 

SetCheckBox 

See  Section  2.22.1.11.7. 

Table  2.22-32  DialogLookupField  Information. 


2.22.1.13  diamand.c 

DevelopmentrSIMNET  :libniac;diainand.c 

diamand.c  contains  a  routine  for  ensuring  that  mandatory  dialog  fields  are  filled. 

2.22.1.13.1  CheckMandatoryFields 

CheckMandatoryFields  ensures  that  all  mandatory  fields  are  filled  in.  state  is  the  pointer  to 
Dialog  to  be  checked.  The  function  call  is  ChecI^andatoryFields(state).  Table  2.22-33 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


state 


Parameters 


register  pointer  to  OialogState 


Where  Tvoedef  Declared 


Development.SIMNET.libmac; 

dialOQ.h 


Internal  Variables 

Variable 

Where  Typedef  Declared 

fpp 

pointer  to  pointer  to  FieldDefn 

Development:SIMNET  :libmac: 

dialOQ.h 

theltem 


int 


Handle 


Standard  C  type. 


DevelopmentiTHINK  C: 
Mac  #includes:MacTypes.h 


DeyelopmentTHINK  C: 
Mac  #includes:MacTypes.h 


Standard  C  type. 


Return  Values 


Return  Value 


1 


0 


Meanin 


AH  mandatory  fields  filled  in. 


Mandatory  field  must  be  filled 
in. 


Calls 

Function 

Where  Described 

GetDItem 

Standard  Dialoq  Manager  function  for  Macintosh. 

GetIText 

Standard  Dialoq  Manager  function  for  Macintosh. 

SellText 

Standard  Dialog  Manager  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

CtoPstr 


Table  2.22-33  CheckMandatoryFields  Information. 
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2.22.1.14  dtg.h 

Development:S]MNET:libmac:dtg.h 

dtg.h  is  the  header  file  associated  with  the  following  file,  dtg.c(Section  2.22.1.15). 


2.22.1.15  dtg.c 

Development:SIMNET:libmac:dtg.c 


dtg.c  contains  routines  for  input,  output,  and  processing  of  date  time  groups.  Table  2.22- 
34  describes  the  variables  us^  by  dtg.c. 


1  Variables  I 

Variable 

Where  Tvpedef  Declared 

currentTime 

DateTimeGroup 

DevelopmentiSIMNET  ilibmac: 
dta.h 

monthAbbrevfl 

char 

Standard  C  type. 

monthLenqthn 

char 

Standard  C  type. 

Table  2.22-34  dtg.c  Variable  Information. 


2.22.1.15.1  DTGToString 

DTGToString  generates  a  string,  str,  from  a  DateTimeGroup  object,  dtg.  The  function  call 
is  DTGToString(dtg,  str).  Table  2.22-35  describes  the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dtg 

register  pointer  to 
DateTimeGroup 

DevelopmentiSIMNET  ilibmac: 
dtg.h 

str 

register  pointer  to  char 

Standard  C  type. 

1  Called  By  1 

Function 

Where  Described 

DrawCtock 

See  Section  2.22.1.6.1. 

'l»l  1  111  1  III!  1 

See  Section  2.22.1.11.2, 

Table  2.22-35  DTGToString  Information. 

2.22.1.15.2  StringToDTG 

StringToDTG  convens  a  string,  cp,  to  a  DateTimeGroup  object,  dtg.  The  string  is  not 
expected  to  include  a  year,  although  the  year  must  be  specified  in  the  DateTimeGroup 
object  produced.  So  the  appropriate  year  is  deduced  from  the  current  time  on  the 
Macintosh.  The  function  call  is  StringToDTG(cp,  dtg).  Table  2.22-36  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

cp 

register  pointer  to  char 

Standard  C  type. 

dtg 

pointer  to  DateTimeGroup 

DevelopmentiSIMNET  ilibmac. 
dtg.h 
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Internal  Variables 


Variable 


time 


hour 


minute 


month 


monthName 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Return  Values 


Return  Value 


DTG  SUCCESS 


DTG_ERROR 


DTG  BAD  DAY 


DTG  BAD  HOUR 


DTG  BAD  MINUTE 


Type 


int  =  0 


int  =  1 


int  =  2 


int  =  3 


»nt  =  4 


Meanin 


DTG  String  parsed  oka 


DTG  string  has  lexical  error. 


DTG  day  out  of  range. 


DTG  hour  out  of  range. 


DTG  minute  out  of  range. 


Function 


GetDateTime 


Secs2Date 


Date2Secs 


Calls 


Where  Described 


Standard  Ooeratina  System  Utility  function  for  Macintosh. 


Standard  Ooeratina  System  Utility  function  for  Macintosh. 


Standard  Ooeratina  System  Utility  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

CheckLastField 

See  Section  2.22.1.11.5. 

2.22.1.15.3 


Table  2.22-36  StringToDTG  Information. 
DTGEIapsed 


DTGElapsed  sets  a  DateTimeGroup  data  object,  dtg,  from  an  elapsed  time  value,  secs,  (in 
seconds  from  Jan.  1, 1904).  The  function  call  is  DTGElapsed(secs,  dtg).  Table  2.22-37 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


secs 


dtg 


IEi73 


Parameters 


e  Where  Typedef  Declared 


unsigned  long  Standard  C  type. 


pointer  to  DateTimeGroup  DevelopmentiSIMNET :libmac: 

dta.h 


Function 


Secs2Date 


Calls 


Where  Described 


Standard  Ooeratina  System  Utility  function  for  Macintosh. 


Function 


DrawClock 


Called  B 


Where  Described 


See  Section  2.22.1.6.1. 


Table  2.22-37  DTGEIapsed  Information. 
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2.22.1.15.4  Get_DTG 

Get_DTG  retrieves  the  current  time  as  a  DateTimeGroup,  dtg.  The  function  call  is 
Get_DTG(dtg).  Table  2.22-38  describes  the  parameters  us^  and  functions  called  using 
this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dtg 

pointer  to  DateTimeGroup 

DevelopmentiSIMNET  ;libmac: 
dtq.h 

Calls 

Function 

Where  Described 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

Secs2Date 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

Table  2.22-38  Get  DTG  Information. 


2.22.1.16  force.c 

Development:SIMNET:libmac:force.c 

force.c  contains  routines  supporting  the  concept  of  forces  (e.g.,  "US"  and  "Soviet"). 

2.22.1.16.1  LabelForceButtons 

LabelForceButtons  labels  radio  buttons  that  display  a  choice  of  forces.  The  itemNo  passed 
is  that  of  the  first  of  three  radio  buttons,  corresponding  to  force  IDs  1, 2  and  3.  The 
battleScheme  parameter  determines  whether  the  first  two  buttons  are  labelled  “Offense”  and 
“Defense”,  or  “US”  and”Soviet”.  The  forcelD  parameter  specifies  which  button(s)  is/are 
enabled.  If  it  is  forcelDIrrelevant  or  observerForcelD,  all  three  buttons  are  enabled.  The 
function  call  is  LabelForceButtons(dialog,  itemNo,  battleScheme,  forcelD).  Table  2.22-39 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

DialogRr 

DevelopmentTHINK  C 

Mac  #includes;DialoqMqr.h 

itemNo 

int 

Standard  C  type. 

battleScheme 

int 

Standard  C  type. 

forcelD 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

theltem 

Handle 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

box 

Rect 

DevelopmentTHINK  C. 

Mac  #includes:MacTypes.h 

titleAM 

pointer  to  char 

titleBll 

pointer  to  char 

standard  C  type.  1 
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1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialoa  Manaqer  function  for  Macintosh. 

SetCTitle 

Standard  Control  Manaaer  function  for  Macintosh. 

EnableControl 

See  Section  2.22.1.7.2. 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.22-39  LabelForceButtons  Information. 

2.22.1.16.2  ForceNamePStr 

ForceNamePStr  returns  the  name  of  a  force  undei  a  particular  battle  scheme  as  a  Pascal 
string.  The  function  call  is  ForceNamePStr(forceID,  battleScheme).  The  function  call 
returns  a  pointer  to  a  string.  Table  2.22-40  describes  the  parameters  usedby  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

force  ID 

int 

Standard  C  tvoe. 

battleScheme 

int 

Standard  C  tvoe. 

Return  Values 

Return  Value 

Type 

Meaning 

str 

pointer  to  char 

Name  of  force. 

Table  2.22-40  ForceNamePStr  Information. 

2.22.1.17  help.h 

Development:SIMNET  :libmac:help.h 

help.h  is  the  header  file  defining  the  external  interface  to  the  following  collection  of  help 
routines. 

2.22.1.18  helplocal.h 

Development:SIMNET:libmac:helplocal.h 

helplocal.h  is  the  header  file  containing  internal  definitions  associated  with  the  following 
collection  of  help  routines. 

2.22.1.19  help.c 

E)evelopment:SIMNET:libmac:help.c 

help.c  contains  routines  providing  user  access  to  a  database  of  help  material.  Table  2.22- 
41  describes  the  variables  used  by  help.c. 
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1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

curhelp 

int 

Standard  C  type. 

helpfid 

int 

Standa'-d  C  type. 

helphandle 

Handle 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

helpareaheiQht 

int 

Standard  C  type. 

helplineheioht 

int 

Standard  C  type. 

helpmaxoriain 

int 

Standard  C  type. 

int 

Standard  C  type. 

helprect 

Reel 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

helpscroll 

ControlHandle 

Development:THINK  C: 

Mac  #includes:ControlMqr.h 

helpscrstate 

unsigned  int 

Standard  C  type. 

helplitlelTITLEMAX) 

char 

Standard  C  type. 

helpupdrgn 

RgnHandle 

Devetopment:THINK  C: 

Mac  #includes:Ouickdraw.h 

helpvars 

Handle 

DevelopmentTHINK  C; 

Mac  #includes;MacTypes.h 

holdclip 

RgnHandle 

Development:THINK  C: 

Mac  #includes:Ouickdraw.h 

lasthelp 

int 

Standard  C  type. 

nohelp 

Boolean 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

numchunks 

int 

Standard  C  type. 

topiccount 

int 

Standard  C  type. 

topiclist 

ListHandle 

DevelopmentiTHINK  C: 

Mac  #includes:ListMar.h 

topichdl 

Handle 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

topicnames 

Handle 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

topics 

Handle 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

Table  2.22-41  help.c  Variable  Information. 


2.22.1.19.1  helpinit 

helpinit  initializes  the  help  facility.  It  is  called  once  at  program  startup.  The  function  call  is 
helpinit(helpfile).  Table  2.22-42  describes  the  parameters  used,  errors  returned  and 
functions  called  using  this  function,  helpfile  is  the  address  of  a  pascal  type  string 
containing  the  name  of  the  help  resource  file,  if  NIL  is  passed,  no  file  will  be  opened  and 
the  help  resources  will  be  assumed  to  be  in  an  already  opened  resource  file. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

helpfile 

pointer  to  char 

Standard  C  type. 
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variable 


curtopic 


helDindex 


helDid 


initresult 


mhiphdl 


Internal  Variables 


int 


int 


mt 


int 


Handle 


inter  to  char 


textien 

unsianed  Ion 

tODiclen 

unsianed  Ion 

inter  to  int 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Development;THINK  C; 
Mac  #includes:MacTvDes.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Return  Values 


Return  Value 


initresult 


Meanin 


0  if  no  errors,  otherwise  error 
any  error  encountered. 


Function 


OoenResFile 


ResError 


GetIndResource 


HLock 


NewHandle 


GetResource 


HNoPuroe 


SetHandleSize 


BlockMove 


HPuroe 


ReleaseResource 


DisoosHandle 


HUnlock 


2.22.1.19.2 


Calls 


Where  Described 


Standard  Resource  Manaaer  function  for  Macintosh. 


Standard  Resource  Manaaer  function  for  Macintosh. 


Standard  Resource  Manaaer  function  for  Macintosh. 


Standard  Memory  Manaaer  function  for  Macintosh. 


Standard  Memory  Manaaer  function  for  Macintosh. 


Standard  Resource  Manaaer  function  for  Macintosh. 


Standard  Memory  Manaaer  function  for  Madntosh. 


Standard  Memory  Manaaer  function  for  Macintosh, 


Standard  Memory  Manaaer  function  for  Macintosh. 


Standard  Memory  Manaaer  function  for  Macintosh. 


Standard  Resource  Manaaer  function  for  Macintosh. 


Standard  Memory  Manaaer  function  for  Macintosh. 


Standard  Memory  Manaaer  function  for  Macintosh. 


Table  2.22-42  helpinit  Information, 
helpshutdown 


helpshutdown  shut  down  the  help  facility.  The  function  call  is  helpshutdown().  Table 
2.22*43  describes  the  internal  variables  used  and  functions  called  using  this  function. 
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1  ^  Caiis  1 

Function 

Where  Described 

DisposHandle 

Standard  Memory  Manaoer  function  for  Macintosh. 

GetHandleSize 

Standard  Menx>ry  Manager  function  for  Macintosh. 

CloseResFile 

Standard  Resource  Manager  function  for  Macintosh. 

Table  2.22-43  helpshutdown  Information. 

2.22.1.19.3  sethelpvar 

sethelpvar  sets  the  contents  of  a  help  variable.  The  function  call  is  sethelpvar(variable, 
varcontents).  Table  2.22-44  describes  the  parameters  used  and  functions  called  using  this 
function,  variable  is  a  pointer  to  a  string  containing  the  variable  name;  varcontents  is  a 
pointer  to  a  string  containing  the  new  contents  for  the  variable. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

variable 

pointer  to  char 

Standard  C  type. 

varcontents 

pointer  to  chcr 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

addlen 

long 

Standard  C  type. 

contenthdl 

Handle 

DevetopmentTHINK  C; 

Mac  #includes:MacTvpes.h 

contlen 

int 

Standard  C  type. 

count 

int 

Standard  C  type. 

curlen 

long 

Standard  C  type. 

tempi  ptr 

pointer  to  char 

Standard  C  type. 

temp2ptr 

pointer  to  char 

Standard  C  type. 

vatlen 

int 

Standard  C  type. 

varnotfound 

Boolean 

DeveiopmentTHINK  C; 

Mac  #includes:MacTypes.h 

1  Calls  1 

Function 

Where  Described 

SetHandleSize 

Standard  Memory  Manager  function  for  Macintosh. 

GetHandleSize 

Standard  Memory  Manager  function  for  Macintosh. 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

Table  2.22-44  sethelpvar  Information. 

2.22.1.19.4  showhelp 

showhelp  displays  the  specified  help  screen.  The  function  call  is  showhelp(helpid).  Table 
2.22-45  describes  the  parameters  used  and  functions  called  using  this  function,  helpid  is 
the  id  number  of  the  help  screen  to  display.  If  helpid  is  zero,  the  topics  menu  will  be 
displayed  and  the  user  can  choose  any  help  screen. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

helpid 

int 

Standard  C  type. 
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Internal  Variables 

Variable 

Where  Tvoedef  Declared 

done 

Boolean 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

helpdioghdl 

Handle 

DevelopmentTHINK  C: 

Mac  #tncludes;MacTypes.h 

CHiaESB 


helDdlooname 


helpdiogtype 


helpdptr 


int 


char 


ResType 


DialogRr 


Standard  C  t 


Standard  C  t 


Development;THINK  C: 
Mac  #includes;MacTypes.h 


Development:THINK  C; 
Mac  #includes:DialoqMQr.h 


Function 


ShowCaution 


NewRon 


GetNamedResource 


GetResInfo 


GetNewDialo 


centerdialo 


SetPort 


Outline  Item 


setuDhtODic 


setuDhoick 


Calls 


Where  Described 


See  Section  2.22.1.4.1. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Resource  Manaoer  function  for  Macintosh. 


Standard  Resource  Manager  function  for  Macintosh. 


Standard  Dialoo  Manager  function  for  Macintosh. 


See  Section  2.22.1.19.5. 


Standard  Quidcdraw  function  for  Macintosh. 


See  Section  2.22.1.27.2. 


See  Section  2.22.1.19.16. 


See  Section  2.22.1.19.8. 


Called  B 


Function 

Where  Described 

DialogSegEvent 

See  Section  2.22.1.39.3. 

2.22.1.19.5 


Table  2.22-45  showhelp  Information, 
centerdialog 


centerdialog  centers  a  dialog  box  on  the  current  screen.  The  function  call  is 
centerdialog (dptr).  Table  2.22-46  describes  the  parameters  used  and  functions  called  using 
this  function,  dptr  is  a  pointer  to  the  dialog  to  center. 


Parameters 


Parameter 


dptr 


e 


Dialog  Ptr 


Where  Tvoedef  Declared 


DevelopmentTHINK  C: 
Mac  #jncludes;OialogMgr.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dialogheight 

int 

Standard  C  type. 

dialogleft 


dialooto 


diaiogwidth 


screenheight 


screenwidth 


Standard  C  t 


Standard  C  t 


Standard  C  tvoe. 


Standard  C  t 


Standard  C  type. 
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_ _ Calls _ 

Function  I  Where  Described 

Move  Window_ Standard  Window  Manager  function  for  Macintosh. 


_ _ Called  By 

Function  [Where  Described  ~ 

showhelp _ See  Section  2.22.1. 19.4. 


Table  2.22-46  centerdialog  Information. 

2.22.1.19.6  hpickevents 

hpickevents  is  the  event  handler  for  the  hpick  dialog  box.  The  function  call  is 
hpickevents(wptr,  eventptr).  Table  2.22-47  describes  the  parameters  used  and  functions 
called  using  this  function,  wptr  is  a  pointer  to  the  dialog  box  window;  eventptr  is  a  pointer 
to  the  event  record. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

wptr 

WindowRr 

DevelopmentiTHINK  C: 

Mac  #includes:WindowMQr.h 

eventptr 

pointer  to  EventRecord 

DevelopmentTHINK  C: 

Mac  #includes;EventMqr.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

clicked 

Point 

DevelopmentiTHINK  C; 

Mac  #includes:MacTypes.h 

doubleclick 

Boolean 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

fontnum 

int 

Standard  C  type. 

holdport 

GrafPtr 

Development'.THINK  C; 

Mac  #includes:Quickdraw.h 

itemhandle 

Handle 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes,h 

itemhit 

int 

Standard  C  type. 

itemrect 

Rect 

DevelopmentTHINK  C; 

Mac  #includes;MacTypes.h 

itemtype 

int 

Standard  C  type. 

orqlont 

int 

Standard  C  type. 

orqsize 

int 

Standard  C  type 

scrollrect 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

state 

int 

Standard  C  type. 

testcell 

Cell 

DevelopmentiTHINK  C: 

Mac  #includes;ListMqr  h 

topicptr 

pointer  to  int 

Standard  C  type. 

topicsel 

Boolepri 

Development:THINK  C: 

Mac  #includes,MacTypes  h 

1  1 
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1  Calls  j 

Function 

Where  Described 

Gel  Port 

Standard  Quickdraw  function  for  Macintosh. 

Set  Port 

Standard  Quickdraw  function  for  Macintosh. 

GetFNum 

Standard  Font  Manager  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

Text  Size 

Standard  Quickdraw  function  for  Macintosh. 

LActivate 

Standard  List  Manager  function  for  Macintosh 

DialoaSelect 

Standard  Dialog  Manager  function  for  Macintosh. 

LGetSelect 

Standard  List  Manager  function  for  Macintosh. 

SetRectRan 

Standard  Quickdraw  function  for  Macintosh. 

GetClip 

Standard  Quickdraw  function  for  Macintosh. 

SetClip 

Standard  Quickdraw  function  for  Macintosh. 

LDispose 

Standard  List  Manager  function  for  Macintosh. 

setuphtopic 

See  Section  2.22.1.19.16. 

OisposDiaioq 

Standard  Dialog  Manager  function  for  Macintosh. 

DisposeRan 

Standard  Quickdraw  function  for  Macintosh. 

GlobalToLocal 

Standard  Quickdraw  function  for  Macintosh. 

LCIick 

Standard  List  Manager  function  for  Macintosh. 

PtInRect 

Standard  Quickdraw  function  for  Macintosh. 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

HiliteControl 

Standard  Control  Manager  function  for  Macintosh. 

Table  2.22<47  hpickevents  Information. 


2.22.1.19.7  drawlist 

drawlist  is  called  by  the  dialog  manager  to  update  the  topic  list.  The  function  call  is 
drawlist(dptr,  itemno).  Table  2.22-48  describes  the  parameters  used  and  functions  called 
using  this  function,  ^tr  is  a  pointer  to  the  dialog  box  to  use;  itemno  is  the  item  number  of 
the  topic  list. 
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Calls 

Function 

Where  Described 

PenSize 

Standard  Quickdraw  function  for  Macintosh. 

InsetRect 

Standard  CXjickdraw  function  for  Macintosh. 

FrameRect 

Standard  Quickdraw  function  for  Macintosh. 

GetFNum 

Standard  Font  Manaaer  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

TextSize 

Standard  Quickdraw  function  for  Macintosh. 

Standard  List  Manaaer  function  for  Macintosh. 


Table  2.22-48  drawlist  Information. 


2.22.1.19.8 


setuphpick 


setuphpick  setups  the  dialog  box  to  let  the  user  choose  a  topic.  The  function  call  is 
setuphpick(dptr).  Table  2.22-49  describes  the  parameters  used  and  functions  called  using 
this  function,  dptr  is  a  pointer  to  the  dialog  box  to  use. 
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1  Calls  1 

Function 

Where  Described 

helpidindex 

See  Section  2.22.1.19.18. 

GetDItem 

Standard  Oialoq  Manager  function  for  Macintosh. 

SetCTitle 

Standard  Control  Manager  function  tor  Macintosh. 

HiliteControl 

Standard  Control  Manager  function  tor  Macintosh. 

SetIText 

Standard  Dialog  Manager  function  for  Macintosh. 

EraseRect 

Standard  Quickdraw  function  for  Macintosh. 

SetRect 

Standard  Quickdraw  function  for  Macintosh. 

GetFNum 

Standard  Font  Manager  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

TextSize 

Standard  Quickdraw  function  for  Macintosh. 

LNew 

Standard  List  Manager  function  for  Macintosh. 

LDoOraw 

Standard  List  Manager  function  for  Macintosh. 

SetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

HLock 

Standard  Memory  Manager  function  for  Macintosh. 

LSetCell 

Standard  List  Manager  function  for  Macintosh. 

HUnlock 

Standard  Memory  Manager  function  for  Macintosh. 

LSetSelect 

Standard  List  Manager  function  for  Macintosh. 

LAutoScroll 

Standard  List  Manager  function  for  Macintosh. 

LActivate 

Standard  List  Manager  function  for  Macintosh. 

ShowWindow 

Standard  Window  Manager  function  for  Macintosh. 

SetWRefCon 

Standard  Dialog  Manager  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

showhelp 

See  Section  2.22.1.19.4. 

htopicevents 

See  Section  2.22.1.19.14. 

setuphtopic 

See  Section  2.22.1.19.16. 

Table  2.22*49  setuphpick  Information. 


2.22.1.19.9  redrawhelp 

redrawhelp  redraws  the  chunks  that  are  in  the  redraw  area.  The  function  call  is 
redrawhelp(dptr,  top,  bottom).  Table  2.22-50  describes  the  parameters  used  and  functions 
called  using  this  function,  dptr  is  a  pointer  to  the  dialog  containing  the  redraw  area;  top  is 
the  top  of  the  area  to  redraw;boKom  is  the  bottom  of  the  area  to  redraw. 
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1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

curchunk 

int 

Standard  C  type. 

curoriQin 

int 

Standard  C  type. 

destrect 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

hpicthdl 

heippicthdl 

Development;SIMNET  :libmac; 
helplocal.h 

orgface 

Style 

Development;THINK  C: 

Mac  #includes:Ouickdraw.h 

orafont 

int 

Standard  C  type. 

orqsize 

int 

Standard  C  type. 

picthdl 

PicHandle 

DevelopmentiTHINK  C: 

Mac  #includes;Ouickdraw.h 

topichandle 

Handle 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTypes.h 

topicheiQht 

int 

Standard  C  type. 

topicsptr 

topicchunkptr 

Development  iSIMNET  ilibmaci 
helplocal.h 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

TEUpdate 

Standard  TextEdit  function  for  Macintosh. 

Text  Font 

Standard  Ouickdraw  function  for  Macintosh. 

TextSize 

Standard  Ouickdraw  function  for  Macintosh. 

Text  Face 

Standard  Ouickdraw  function  for  Macintosh. 

DrawPicture 

Standard  Ouickdraw  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

scrollto 

See  Section  2.22.1.19.11. 

drawtopic 

See  Section  2.22.1.19.15. 

Table  2.22-50  redrawhelp  Inrormation. 


2.22.1.19.10  adjustchunks 

adjustchunks  adjusts  the  locations  of  all  the  chunks,  dist  is  the  amount  by  which  to  adjust 
the  chunks.  The  function  call  is  adjustchunks(dist).  Table  2.22-51  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 

dist 


int 


Parameters 


Where  Typedef  Declared 

Standard  C  type. _ 


BBN  Systems  and  Technologies 


Variable 


curchunk 


hpicthdl 


topichandle 


topicsptr 


Internal  Variables 


e 


int 


heippicthdi 


TEHandle 


Handle 


topicchunkptr 


MCC  CSCI 


Where  Tvoedef  Declared 


Standard  C  t 


Development.'SIMNET  ilibmac: 
helDlocal.h 


Development:THINK  C: 
Mac  #inctudes:TextEdit.h 


Developmenf.THINK  C: 
Mac  #includes;MacTypes.h 


Development;SIMNET  ilibmac. 
helpiocal.h 


Standard  C  t 


Function 


OffsetRect 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

scrollto 

See  Section  2.22.1.19.11. 

2.22.1.19.11 


Table  2.22-51  adjustchunks  Information, 
scrollto 


scroUto  scrolls  the  help  topic  to  the  neworigin.  dptr  is  the  pointer  to  the  dialog  containing 
control  and  neworigin  is  the  origin  to  scroU  the  topic  to.  TTie  function  call  is  scrollto(dptr, 
neworigin).  Table  2.22-52  describes  the  parameters  used  and  funaions  called  using  this 
function. 


Parameters 

Parameter 

Type 

Where  Tvoedef  Declared 

dptr 

DialogRr 

Development:THINK  C: 

Mac  #includes:DialogMgr.h 

neworigin 

int 

Standard  C  type. 

Variable 


bottom 


itemhandle 


itemrect 


itemtvpe 


newvalue 


scrolldist 


testdist 


Internal  Variables 


e 


int 


Handle 


lEim 


int 


unsioned  Ion 


int 


int 


int 


Where  Tvoedef  Declared 


Standard  C  type. 


Development:THINK  C; 
Mac  #includes;MacT 


DevelopmentiTHINK  C: 
Mac  #includes:MacT 


Standard  C  t 


Standard  C  type. 


Standard  C  t 


Standard  C  t 


Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

adjustchunks 

See  Section  2.22.1.19.10. 

GetClip 

Standard  Quickdraw  function  for  Macintosh. 

ClipRect 

Standard  Quickdraw  function  for  Macintosh. 

Erase  Rect 

Standard  Quickdraw  function  for  Macintosh. 

redrawhelp 

See  Section  2.22.1.19.9. 

SetClip 

Standard  Quickdraw  function  for  Macintosh. 

ScrollRect 

Standard  Quickdraw  function  for  Macintosh. 

SetCtIValue 

Standard  Control  Manaaer  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

trytoscroll 

See  Section  2.22.1.19.12. 

htopicevents 

See  Section  2.22.1.19.14. 

Table  2.22-52  scrollto  Information. 

2.22.1.19.12  trytoscroll 

trytoscroU  is  called  by  TrackControl  (indirectly)  to  try  to  scroll  the  topic  by  the  amount 
specified,  dptr  is  a  pointer  to  the  dialog  containing  control  and  count  is  the  number  of 
pixels  to  scroll  the  window.  The  function  call  is  trytoscroll(dptr,  count).  Table  2.22-53 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dptr 

DialogRr 

Development:THINK  C: 

Mac  #includes:DiaioaRr.h 

count 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

neworiqin 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

scrollto 

See  Section  2.22.1.19.11. 

1  Called  By  I 

Function 

Where  Described 

helpmove 

See  Section  2.22.1.19.13. 

Table  2.22-53  trytoscroll  Information. 
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2.22.1.19.13 


helpmove 


helpmove  is  called  by  TrackControl  to  scroll  the  topic,  ctrlhdl  is  the  handle  to  the  scroll  bar 
and  part  is  the  part  number  where  the  user  clicked.  The  function  call  is  helpmove(ctrlhdl, 
part).  Table  2.22-54  describes  the  parameters  used  and  functions  called  using  this 
function. 


Parameters 


Parameter 


ctrlhdl 


lEiT! 


ControlHandle 


Variable 


dptr 


Internal  Variables 


e 


Dialog  Ptr 


lEin 


Where  Tvoedef  Declared 


Development:THINK  C: 

Mac  #includes:ControlMqr.h 


Standard  C  t 


Where  Tvoedef  Declared 


DevelopmentrTHINK  C: 
Mac  #includes:DialoaMQ.h 


Function 


trvtoscroll 


Calls 


Where  Described 


See  Section  2.22.1.19.12. 


Table  2.22-54  helpmove  Information. 

2.22.1.19.14  htopicevents 

htopicevents  is  the  event  handler  for  the  htopic  dialog  box.  wptr  is  the  pointer  to  the  dialog 
box  window  and  eventptr  is  the  pointer  to  the  event  record.  The  function  call  is 
htopiccvents(wptr,  eventptr).  Table  2.22-55  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameters 


Parameter 


wptr 


eventptr 


Variable 


itemhit 


lastpart 


newmdex 


newonoin 


newvalue 


userclick 


whichcontrol 


whichoart 


WindowRr 


pointer  to  EventRecord 


Internal  Variables 


e 


int 


int 


int 


unsioned  Ion 


unsiqned  Ion 


inter  to  int 


Point 


ControlHandle 


Where  Tvoedef  Declared 


DevelopmentTHINK  C: 

Mac  #includes:WindowPtr.h 


Development;THINK  C; 
Mac  #includes;EventMqr.h 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


DevelopmentrTHINK  C: 
Mac  #includes:MacTypes.h 


DeyelopmentrTHINK  C: 

Mac  #includes:ControlMqr.h 


Standard  C  t 
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1  Calls  1 

Function 

Where  Described 

HiliteControl 

Standard  Control  Manager  function  for  Macintosh. 

DialogSelect 

Standard  Dialog  Manager  function  for  Macintosh. 

See  Section  2.22.1.19.17. 

SetRectRan 

Standard  Quickdraw  function  for  Macintosh. 

GetClip 

Standard  Quickdraw  function  for  Macintosh. 

SetClip 

Standard  Quickdraw  function  for  Macintosh. 

DisposeControl 

Standard  Control  Manager  function  for  Macintosh. 

setuphpick 

See  Section  2.22.1.19.8. 

DisposDialOQ 

Standard  Dialog  Manager  function  for  Macintosh. 

OisposeRan 

Standard  Quickdraw  function  for  Macintosh. 

helpidindex 

See  Section  2.22.1.19.18. 

setuphtopic 

See  Section  2.22.1.19.16. 

GlobalToLocal 

Standard  Quickdraw  function  for  Macintosh. 

FindControl 

Standard  Control  Manager  function  for  Macintosh. 

TrackControl 

Standard  Control  Manager  function  for  Macintosh. 

GetCtIValue 

Standard  Control  Manager  function  for  Macintosh. 

scroilto 

See  Section  2.22.1.19.11. 

Table  2.22-55  htopicevents  Information. 


2.22.1.19.15  drawtopic 

drawtopic  is  called  by  the  dialog  manager  to  display  a  topic,  dptr  is  a  pointer  to  the  dialog 
box  to  use  and  itemno  is  the  item  number  of  the  topic  item.  The  function  call  is 
drawtopic(dptr,  itemno).  Table  2.22-56  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

dptr 

DialogRr 

DevelopmentiTHINK  C: 

Mac  #includes;DialogMgr.h 

itemno 

int 

Standard  C  type. 

Variable _ Type _ Where  Typedef  Declared 

itemhandle  Handle  DevelopmentiTHINK  C: 


_ Mac  #includes:MacTypes.h 

itemrecl  Reel  Development;THINK  C; 

_ Mac  #includes:MacTvpes.h 

itemtype_ int_ Standard  C  type. 
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Function 


GetCIi 


GetDItem 


InsetRect 


PenSize 


FrameRect 


DrawControls 


ClipRect 


redrawhel 


SetCIi 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Dialoo  Manaoer  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Control  Manaoer  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh 


See  Section  2.22.1.19.9. 


Standard  Quickdraw  function  for  Macintosh. 


Table  2.22-56  drawtopic  Information. 

2.22.1.19.16  setuphtopic 

setuphtopic  displays  the  specified  help  topic  dialog  box.  dptr  is  the  pointer  to  the  dialog 
box  to  use.  The  function  call  is  setuphtopic(dptr).  Table  2.22-57  describes  the  parameters 
used  and  functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

GetResource 

Standard  Resource  Manaoer  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

setuphpick 

See  Section  2.22.1.19.8. 

HNoPurae 

Standard  Memory  Manaoer  function  for  Macintosh. 

BlockMove 

Standard  Memory  Manaoer  function  for  Macintosh. 

GetDItem 

Standard  Dialoo  Manaoer  function  for  Macintosh. 

SetCTitle 

Standard  Control  Manaoer  function  for  Macintosh. 

HiliteControl 

Standard  Control  Manaoer  function  for  Macintosh. 

SetIText 

Standard  Dialoo  Manaoer  function  for  Macintosh. 

EraseRect 

Standard  CXiickdraw  function  for  Macintosh. 

SetDitem 

Standard  Dialoo  Manaoer  function  for  Macintosh. 

InsetRect 

Standard  Quickdraw  function  for  Macintosh. 

NewControl 

Standard  Control  Manaoer  function  for  Macintosh. 

qethelp 

See  Section  2.22.1.19.19. 

SetCtIValue 

Standard  Control  Manaoer  function  for  Macintosh. 

ShowControl 

Standard  Control  Manaoer  function  for  Macintosh. 

Show  Window 

Standard  Window  Manaoer  function  for  Macintosh. 

InvalRect 

Standard  Window  Manaoer  function  for  Macintosh. 

SetWRefCon 

Standard  Window  Manaoer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

showhelp 

See  Section  2.22.1.19.4. 

hpickevents 

See  Section  2.22.1.19.6. 

htopicevents 

See  Section  2.22.1.19.14. 

Table  2.22-57  setuphtopic  Information. 


2.22.1.19.17  disposetopic 

disposetopic  cleans  up  after  finishing  with  a  topic.  The  function  call  is  disposetopic(). 
Table  2.22-58  describes  the  parameters  used  and  functions  called  using  this  function. 


Variable 


curchunk 


topicsptr 


topichandle 


Internal  Variables 


e 


int 


topicchunkptr 


Handle 


Where  Typedef  Declared 


Standard  C  type. 


Development:SIMNET  ilibmac: 
helplocal.h 


DevelopmentiTHINK  C: 
Mac  #includes:MacTvpes  h 


Standard  C  t 


Calls 

Function 

Where  Described 

HPuroe 

Standard  Memory  Manaoer  tunciion  for  Macintosh. 

ReleaseResource 

Standard  Resource  Manaoer  function  for  Macintosh 

TEDispose 

Standard  TextEdit  function  for  Macintosh. 

DisposHandle 

Standard  Memory  Manager  function  for  Macintosh. 
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Called  B 


Function 

Where  Described 

htopicevents 

See  Section  2.22.1.19.14. 

Table  2.22*58  disposetopic  Information. 

2.22.1.19.18  helpidindex 

helpidindex  returns  the  index  for  a  given  id.  helpid  is  the  id  of  the  help  resource  to  find. 
The  function  call  is  helpidindexfhelpid).  Table  2.22-59  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 


Parameter 


helpid 


Variable 


helDindex 


retindex 


lETT! 


lEiT? 


Internal  Variables 


e 


inter  to  int 


Return  Values 


Where  Tvoedef  Declared 


Standard  C  type. 


Where  Tvpedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Return  Value 


retindex 


Meanln 


Index  number  o1  the  id. 


Called  B 


Function 

Where  Described 

setuphpick 

See  Section  2.22.1.19.8. 

htopicevents 

See  Section  2.22.1.19.14. 

Table  2.22*59  helpidindex  Information. 

2.22.1.19.19  gethelp 

gethelp  sets  up  the  topic  data,  given  a  help  handle,  helphdl  is  the  handle  of  the  help 
resource  to  setup.  The  function  call  is  gethelp(helphdl,  destrect,  controlstate,  scrollmax). 
Table  2.22-60  describes  the  parameters  used  and  functions  called  using  this  function. 
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Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

chunkptr 

hchunkptr 

Development:SIMNET  ilibmac: 
helplocal.h 

curchunk 


curoriQin 


hchunkid 


hchunktype 


skiDCount 


topicshdl 


topicsptr 


topichandle 


toDicheiQht 


e 


int 


int 


int 


ResType 


inter  to  char 


unsianed  int 


Handle 


topicchunkptr 


Handle 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Development  THINK  C: 
Mac  #includes;MacT 


Standard  C  t 


Standard  C  t 


Development.THINK  C; 
Mac  #includes;MacTypes.h 


DevelopmentiSIMNET  ;libmac: 
helplocal.h 


Development.THINK  C; 
Mac  #includes;MacTvDes.h 


Standard  C  type. 


Standard  C  t 


Return  Value 


topicshdl 


Return  Values 


Handle 


Meanin 


Handle  to  topic  structure. 


Function 


NewHandle 


createte 


createhoict 


Calls 


Where  Described 


Standard  Memory  Manaaer  function  for  Macintosh. 


See  Section  2.22.1.19.22. 


See  Section  2.22.1.19.23. 


Called  B 


Function 

Where  Described 

setuphtopic 

See  Section  2.22.1.19.16. 

Table  2.22-60  gethelp  Information. 

2.22.1.19.20  getcontenthdl 

getcontenthdl  returns  the  contents  handle  for  a  variable,  varname  is  a  pointer  to  the  string 
containing  the  variable  name  and  varnamelen  is  the  length  of  the  variable  name.  The 
function  call  is  getcontenthdl(vamame,  varnamelen).  Table  2.22-61  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


varname 


varnamelen 


inter  to  char 


Where  Tvpedef  Declared 


Standard  C  t 


Standard  C  t 
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Internal  Variables 


Variable 


curchar 


curlen 


s 


curvar 


match 


tempi  Dtr 


varfound 


varslen 


inter  to  char 


Boolean 


Handle 


inter  to  char 


Boolean 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


Standard  C  t 


Standard  C  t 


Development.THINK  C: 
Mac  #includes:MacTypes.h 


DevelopmentiTHINK  C: 
Mac  #includes;MacTypes.h 


Standard  C  type. 


Development:THINK  C: 
Mac  #includes:MacTypes.h 


Standard  C  t 


Return  Values 


Return  Value 


NIL 


rethdl 


Type 


Handle 


Handle 


Meaning 


Variable  not  found. 


Handle  to  contents  for 
variable. 


Calls 

Function 

Where  Described 

GetHandleSize 

Standard  Memory  Manaqer  function  for  Macintosh. 

Called  B 


Function 

Where  Described 

replacevars 

See  Section  2.22.1.19.21. 

Table  2.22*61  getcontenthdl  Information. 

2.22.1.19.21  replacevars 

replacevars  leplaces  variables  with  their  contents,  txthdl  is  the  handle  to  the  text  for  the 
chunk  and  length  is  a  pointer  to  the  length  of  text  in  the  handle.  The  function  tall  is 
replacevars(txthdl,  length).  Table  2.22-62  describes  the  parameters  used  and  functions 
called  using  this  function. 
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Variable 


contenthdl 


contentlen 


curloc 


lastend 


laststart 


lenathchanoe 


orolenath 


txtotr 


varcomplete 


varlen 


varloc 


varstart 


Function 


etcontenthdl 


GetHandleSize 


BlockMove 


SetHandleSize 


Internal  Variables 


e 


Handle 


int 


int 


int 


int 


int 


unsiqned  Ion 


inter  to  char 


Boolean 


inter  to  char 


Where  Tvoedef  Declared 


Development.THINK  C; 
Mac  #includes:MacTvpes.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  tvoe. 


Standard  C  t 


Standard  C  type. 


DevelopmentTHINK  C: 
Mac  #includes;MacT 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Calls 


Where  Described 


See  Section  2.22.1.19.20. 


Standard  Memory  Manaoer  function  for  Macintosh. 


Standard  Memory  Manaoer  function  for  Macintosh. 


Standard  Menwry  Manaoer  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

createte 

See  Section  2.22.1.19.22. 

Table  2.22*62  replacevars  Information. 

2.22.1.19.22  createte 

createte  creates  a  textedit  record  from  an  ‘htxt’  resource,  hchunkid  is  the  resource  id  of  the 
‘htxt’  resource,  destrect  is  the  rectangle  of  user  area  to  fit  it  into  and  ystart  is  the  y  position 
to  display  the  text  relative  to  the  topic,  height  returns  the  height  of  the  textedit  record  here. 
The  function  call  is  createte(hchunkid,  destrect,  ystart,  height)  Table  2.22-63  describes 
the  parameters  used  and  functions  called  using  this  function. 
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Internal  Variables 

Variable 

Where  Tvpedef  Declared 

fontinfo 

Fontinfo 

DevelopmentiTHINK  C: 

Mac  #includes:Quickdraw.h 

fontnum 


lenath 


orgface 


orafont 


orasize 


realheiaht 


style 


tedrect 


tevrect 


txthandle 


TEHandle 


Handle 


inter  to  char 


Standard  C  t 


Standard  C  t 


Development:THINK  C: 
Mac  #includes;Quickdraw.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Development:THINK  C: 
Mac  #jncludes:MacTYpes.h 


Development.THINK  C: 
Mac  #includes:TextEdit.h 


Development:THINK  C: 
Mac  #includes:MacTvDes.h 


Development:THINK  C: 
Mac  #includes:macTvDes.h 


Standard  C  type. 


Return  Value 


tehdl 


Return  Values 


e 


TEHandle 


Meanin 


Handle  to  textedit  record. 


Calls 

Function 

Where  Described 

GetResource 

Standard  Resource  Manaoer  function  for  Macintosh. 

replacevars 

See  Section  2.22.1.19.21. 

OffsetRect 

Standard  Quickdraw  function  for  Macintosh. 

InsetRect 

Standard  Quickdraw  function  for  Macintosh. 

GetFNum 

Standard  Font  Manager  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

Text  Size 

Standard  Quickdraw  function  for  Macintosh. 

TextFace 

Standard  Quickdraw  function  for  Macintosh. 

GetFontInfo 

Standard  Quickdraw  function  for  Macintosh. 

TENew 

Standard  TextEdit  function  for  Macintosh. 

HLock 

Standard  Memory  Manaoer  function  for  Macintosh. 

TESetText 

Standard  TextEdit  function  for  Macintosh. 

HUnlock 


ReleaseResource 


Standard  Memory  Manaoer  function  for  Macintosh 


Standard  Resource  Manaoer  function  for  Macintosh. 


Function 


ethel 


Called  B 


Where  Described 


See  Section  2.22.1.19.19. 


Table  2.22-63  createte  Information. 
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2.22.1.19.23 


createhpict 


createhpict  creates  a  quickdraw  picture  from  an  ‘hpic’  resource,  hchunkid  is  the  resource  id 
of  the  ‘hpic’  resource,  destrect  is  the  rectangle  of  user  area  to  fit  it  into  and  ystart  is  the  y 
position  to  display  the  picture  relative  to  the  topic,  height  returns  the  height  of  the  picture 
here.  The  function  call  is  createhpict(hchunkid,  destrect,  ystart,  height).  Table  2.22-64 
describes  the  parameters  used  and  functions  called  using  tliis  function. 


Parameter 


hchunkid 


destrect 


start 


heioht 


Variable 


destwidth 


hoffset 


hpichandle 


hpicthdl 


pictdestrect 


pictrect 


r 


ickwidth 


Return  Value 


hpicthdl 


Function 


GetResource 


HNoPurae 


NewHandle 


HLock 


HandToHand 


HUnlock 


OisoosHandie 


OffsetRect 


HPurae 


Release  Resource 


m 


Function 


ethel 


Parameters 


I  Bn 


int 


pointer  to  Rect 


inter  to  int 


Internal  Variables 


e 


int 


int 


Handle 


heippicthdi 


OSErr 


Where  Typedef  Declared 


Standard  C  type. 


Development:THINK  C; 
Mac  #includes;MacTypes.h 


Standard  C  t 


Standard  C  type. 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  t 


Development:THINK  C: 
Mac  #includes;MacTypes.h 


Oevelopment;SIMNET;libmac; 

helplocal.h 


DevelopmentiTHINK  C: 
Mac  #includes:MacTypes.h 


DevelopmentiTHINK  C: 
Mac  #includes:MacTvpes.h 


DevelopmentiTHINK  Ci 
Mac  #includesiMacTypes.h 


Standard  C  type. 


Return  Values 


Type 


heippicthdi 


Meanin 


Handle  to  quickdraw  picture. 


Where 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Calls 


Described 


Resource  Manaoer  function  for  Macintosh. 


Memory  Manaqer  function  for  Macintosh. 


Memory  Manager  function  for  Macintosh. 


Memory  Manaoer  function  for  Macintosh. 


eratino  System  Utility  function  for  Macintosh. 


Merrwry  Manaoer  function  for  Madntosh. 


Merrwry  Manaoer  function  for  Macintosh. 


Quickdraw  function  for  Macintosh. 


Memory  Manaoer  function  for  Macintosh. 


Resource  Manaqer  function  for  Macintosh. 


Called  B 


Where  Described 


See  Section  2.22.1.19.19. 


Table  2.22-64  createhpict  Information, 
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2.22.1.20  init.c 

Development:SIMNET:libmac:init.c 

init.c  contains  a  routine  for  initializing  the  Macintosh  toolbox. 

2.22.1.20.1  InitToolbox 

InitToolbox  initializes  the  Macintosh  toolbox.  The  function  call  is  InitToolbox(masters, 
lestartProc).  Table  2.22-65  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

masters 

int 

Standard  C  type. 

restartProc 

ProcRr 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

Calls 

Function 

Where  Described 

MaxAppIZone 

Standard  Memory  Manaaer  function  for  Macintosh. 

MoreMasters 

Standard  Memory  Manager  function  for  Macintosh. 

InitGraf 

Standard  Quickdraw  function  for  Macintosh. 

InitFonts 

Standard  Font  Manager  function  for  Macintosh. 

FlushEvents 

Standard  Operating  System  Event  Manager  function  for 
Macintosh. 

Init  Windows 

Standard  Window  Manager  function  for  Macintosh. 

TEInit 

Standard  TextEdit  function  for  Macintosh. 

InitOialoQS 

Standard  Dialog  Manaaer  function  for  Macintosh. 

InitCursor 

Standard  Quickdraw  function  for  Macintosh. 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.22-65  InitToolbox  Information. 

2.22.1.21  install.c 

Development:  SIMNET  rlibmac.install.c 

\ 

install.c  contains  a  routine  for  installing  an  entry  into  a  scrolling  table. 

2.22.1.21.1  InstallScrollTableEntry 

InstallScrollTableEntry  either  inserts  or  reinserts  an  entry,  entry,  into  a  scrolling  table, 
specifed  by  defn.  The  function  call  is  InstallSciollTableEntry(defn,  entry).  Table  2.22-66 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

register  pointer  to 
ScrollTableFieldDefn  ■ 

DevelopmentiSiMNET  ilibmac: 
scroll,  h 

entry 

register 

ScrollTableEntryHandle 

Development.SIMNET.libmac: 

scroll.h 

1  1 
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1  Internal  Variables  1 

Variable 

Tvbe 

Where  Tvoedef  Declared 

key 

unsianed  Iona 

Standard  C  type. 

oldRow 

int 

Standard  C  type. 

newRow 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

r 

Rect 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

e 

Scrol  ITable  Entry  Handle 

DevelopmentiSIMNET  rlibmac; 
scroll.h 

savePort 

GrafRr 

Development:THINK  C: 

Mac  #includes;Quickdraw.h 

Calls 

Function 

Where  Described 

ScrollTableEntrvToRow 

See  Section  2.22.1.34.2. 

NextPrev 

Macro  defined  in  select.c  in  Section  2.22.1.37. 

PrevNext 

Macro  defined  in  select.c  in  Section  2.22.1.37. 

SetCtIMax 

Standard  Control  Manaaer  function  for  Macintosh. 

GetPort 

Standard  Quid<draw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

InvalRect 

Standard  Window  Manaaer  function  for  Macintosh. 

Table  2.22-66  InstallScrollTableEntry  Information. 

2.22.1.22  longpt.h 

Development:SIMNET:libmac:longpt.h 

longpt.h  defines  data  types  for  Cartesian  points  and  rectangles  represented  using  32-bit 
integer  coordinates. 


2.22.1.23  longpt.c 

E)evelopment:SIMNET:libmac:longpt.c 

longpt.c  contains  routines  for  operating  on  points  represented  using  32-bit  integer 
coordinates. 

2.22.1.23.1  isqrt 

isqrt  is  an  integer  square  root  algorithm.  The  alogrithm  works  by  noting  that  the  square 
root  of  an  integer  is  the  smallest  of  the  two  most  nearly  equal  factors  of  that  number,  i.e. 
the  2  most  equal  roots  of  255  are  15  and  17,  and  so  15  is  the  square  of  255.  The  function 
call  is  isqrt(numb).  Table  2.22-67  describes  the  parameters  u.s^  and  functions  called  using 
this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

numb 

reaister  Iona 

Standard  C  type. 
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Internal  Variables 


Variable 


uessl 


uess2 


error 


register  Ion 


register  lo 


register  lo 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Return  Values 


Return  Value 


uessl 


numb 


Type 


register  long 


Meanin 


uare  root. 


numb  is  returned  when 
negative  because  square  root 
can  not  be  computed. 


Called  B 


Function 

Where  Described 

DistBetween2Pts 

See  Section  2.22.1.23.2. 

2.22.1.23.2 


Table  2.22-67  isqrt  Information. 
DistBetween2Pts 


DistBetween2Pts  computes  the  distance  between  two  points,  ptl  and  pt2,  using  only 
integers.  The  function  call  is  DistBetween2Pts(ptl,  pt2).  Table  2.22-68  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


ptl 


ifUiZ 


e 


LongPt 


LongPt 


Return  Values 


Where  Typedef  Declared 


DevelopmentiSIMNET  tlibmac; 
.h 


Development.SIMNET  rlibmac; 
.h 


Return  Value 


Meaning 


Return  value  from  called  to 
isgrt. 


Calls 


Function  I  Where  Described 


See  Section  2.22.1.23.1. 


Table  2.22-68  DistBetween2Pts  Information. 
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2.22.1.23.3 


PercentPt 


PercentPt  locates  a  point,  retPt,  a  given  percentage  distant ,  percent,  between  a  start  and  an 
end  point,  points  ptl  and  pt2.  The  function  call  is  PercentFh(ptl,  pt2,  percent,  retPt). 
Table  2.22-69  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

ptl 

LongPt 

Development:SlMNET  iKbrnac; 
lonqpt.h 

pt2 

LongPt 

Development:SIMNET  :libmac; 
lonqpt.h 

percent 

Iona 

Standard  C  type. 

retPt 

pointer  to  LongPt 

Development:SIMNET  :ljbmac: 
lonqot.h 

Table  2.22-69  PercentPt  Information. 

2.22.1.23.4  InterpolatePoints 

InterjwlatePoints  locates  the  point  some  fraction  of  the  way  between  two  other  points.  The 
function  call  is  InterpolatePoints(ptl,  pt2,  num,  denom,  ptint).  Table  2.22-70  describes 
the  parameters  used  by  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

Pt1 

pointer  to  LongR 

Development:SIMNET  ;libmac: 
lonaot.h 

pt2 

pointer  to  LongR 

Development:SiMNET  :libmac: 
lonqpt.h 

num 

long 

Standard  C  type. 

denom 

lonq 

Standard  C  type. 

ptint 

pointer  to  LongR 

DevelopmentiSIMNET  ;libmac; 
lonqpt.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

tract 

float 

Standard  C  type. 

Table  2.22-70  InterpolatePoints  Information. 


2.22.1.23.5  SetLongPt 

SetLongPt  initializes  a  LongPt  value.  The  function  call  is  SetLongPt(pt,  x,  y).  Table  2.22- 
7 1  describes  the  parameters  used  by  this  function. 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

pf 

pointer  to  LongR 

Development:SIMNET  :iibmac: 
lonqpt.h 

X 

lonq 

Standard  C  type. 

y 

lonq 

Standard  C  type. 

Table  2.22-71  SetLongPt  Information. 
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2.22.1.24  lookup. c 

Development:SIMNET  :libmac:lookup.c 

lookup.c  contains  a  routine  for  locating  an  entry  in  a  scrolling  table. 

2.22.1.24.1  LookupScrollTableEntry 

LookupScrollTableEntry  locates  a  scrolling  table  entry  by  its  key.  The  function  call  is 
LookupScrollTableEntry(defn,  key).  Table  2.22-72  describes  the  parameters  used  by  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollTableFietdDefn 

Development.SIMNET  :fibmac; 
scroll.h 

key 

unsianed  Iona 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

e 

register 

ScrollTableEntryHandle 

Development;SIMNET;libmac; 

scroll.h 

Return  Values 

Return  Value 

Type 

Meaning 

e 

register 

ScrollTableEntryHandle 

Handle  of  scrolling  table  entry. 

Table  1.11-11  LookupScrollTableEntry  Information. 


2.22.1.25  map.h 

Development:SIMNET  :libmac:map.h 

map.h  defines  data  types  for  representing  the  mapping  between  UTM  coordinates  and 
Cartesian  world  coordinates.  Table  2.22-73  describes  the  variables  used  by  map.h. 


1  Variables  | 

Variable 

Type 

Where  Typedef  Declared 

terrainMap 

extern  TerrainMap 

DevelopmentiSIMNET  ilibmac; 
map.h 

Table  2.22-73  map.h  Variable  Information. 


1097 


BBN  Systems  and  Technologies 


MCCCSCI 


2.22.1.26  map.c 

DevelopmentrSIMNET  :libmac  :nu^.c 

map.c  contains  routines  for  converting  between  UTM  coordinates  and  Cartesian  world 
coordinates.  Table  2.22-74  describes  the  variables  used  by  map.c. 


Variables 


Variable 


terrainMap 


lEITi! 


TerrainMap 


Where  Tvoedef  Declared 


Oevelopment:SIMNET  ;libmac; 
maoh 


Standard  C  t 


2.22.1.26.1 


Table  2.22-74  map.c  Variable  Information. 
StringToMapCoordinates 


StringToMapCoordinates  parses  a  string,  str,  and  converts  it  to  a  MapCoordinates  object, 
map.  The  function  call  is  StringToMapCoordinates(map,  str).  Table  2.22-75  describes  die 
parameters  used  and  errors  returned  using  this  function. 


Parameters 

Parameter 

Type 

Where  Tvoedef  Declared 

map 

pointer  to  MapCoordinates 

Development;SIMNET  :libmac; 
map.h 

str 

register  pointer  to  char 

Standard  C  type. 

Variable 


Internal  Variables 


e 


extern  function  return! 


reqister  short 


reoister  short 


register  pointer  to  GridZone 


short 


LongPt 


xStrie 


Where  Tvpedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Development:SIMNET  :libmac: 
map.h 


Standard  C  t 


Standard  C  type. 


Return  Value 


-1 


-2 


-3 


0 


Return  Values 


Type 


int 


int 


int 


int 


Meaning 


badMapStringErr 


badMapLetterErr 


outOfGridZoneErr 


Successful 


Error  Name 


badMaoStrinoErr 


badMapLetterErr 


outOfGridZoneErr 


Errors 


Reason  for  Error 


String  too  long  or  contains  wrong  number  of  digits. 


String  letter  pair  doesn't  designate  a  correct  qnd  zone. 


Coordinates  are  not  within  given  grid  zone. 
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1  Called  By  1 

Function 

Where  Described 

CheckLastField 

See  Section  2.22.1.11.5. 

Table  2.11-1  S  StringToMapCoordinates  Information. 
2.22.1.26.2  Poin  tToMa  pCoordinates 

PointToMapCoordinates  builds  a  MapCoordinates  object  fiom  a  set  of  Cartesian 
coordinates  identifying  a  point  on  the  terrain.  The  function  call  is 
PointToMapCoordinates(map,  pt,  prec).  Table  2.22-76  describes  the  parameters  used  and 
errors  returned  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

map 

register  pointer  to 
MapCoordinates 

DevelopmentiSIMNET  :libmac; 
map.h 

pt 

pointer  to  LongPt 

Development.SIMNET  ;libmac: 
longpt.h 

prec 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

n 

register  long 

Standard  C  type. 

CP 

register  pointer  to  char 

Standard  C  type. 

P 

LongPt 

DevelopmentiSIMNET  ilibmac: 
lonapt.h 

zone 

pointer  to  GridZone 

DevelopmentiSIMNET  ilibmaci 
map.h 

punctuate 

short 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-4 

int 

noGridZoneErr 

0 

int 

Successful 

1  Errors  1 

Error  Name 

Reason  for  Error 

noGridZoneErr 

Grid  zone  not  present. 

Table  1.11-16  PointToMapCoordinates  Information. 

2.22.1.27  outline. c 

Development:SIMNET:libmac:outline.c 

outline.c  contains  routines  for  outlining  a  dialog's  default  button. 
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2.22.1.27.1  DrawItemOutline 

DrawItemOutline  is  the  draw  procedure,  called  by  the  Dialog  Manager,  w  is  the  pointer  to 
the  window  the  item  is  in;  itemNo  is  the  number  of  the  item  to  be  outlined.  The  Ainction 
call  is  DrawItemC)utline(w,  itemNo).  Table  2.22-77  describes  the  parameters  used  and 
functions  called  using  this  hincdon. 


j  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

w 

WindowRr 

DevelopmentiTHINK  C; 

Mac  #includes:WindowMar.h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

theltem 

Handle 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

r 

Reel 

DevelopmentrTHINK  C: 

Mac  #includes:MacTypes.h 

Calls 

Function 

Where  Described 

GetDItem 

Standard  Diatoa  Manaoer  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

PenNormal 

Standard  Quickdraw  function  for  Macintosh. 

PenSize 

Standard  Quickdraw  function  for  Macintosh. 

FrameRoundRect 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.22*77  DrawItemOutline  Information. 


2.22.1.27.2  Outlineltem 


Outlineltem  is  called  to  tie  a  drawing  function  to  userltem.  The  function  call  is 
OutlineItem(dialog,  itemNo).  Table  2.22-78  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

dialog 

register  DialogRr 

Development.THINK  C: 

Mac  #includes;OialogMgr.h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

theltem 

Handle 

Development;THlNK  C; 

Mac  #includes:MacTypes.h 

r 

Rect 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

CP 

register  pointer  to  char 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialoo  Manaaer  function  for  Macintosh. 

InsetRect 

Standard  Quickdraw  function  for  Macintosh. 

GetHandleSize 

Standard  Memory  Manaaer  function  for  Macintosh. 

SetHandleSize 

Standard  Memory  Manaaer  function  for  Macintosh. 

MemError 

Standard  Mermry  Manaaer  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

ShowDialoa 

See  Section  2.22.1.11.1. 

showhelp 

See  Section  2.22.1.19.4. 

ShowSimpleDialoq 

See  Section  2.22.1.40.1. 

Table  2.22-78  Outlineltem  Information. 

2.22.1.28  remove.c 

Development:SIMNET:libmac:rcmove.c 

remove.c  contains  a  routine  for  removing  an  entry  from  a  scrolling  table. 

2.22.1.28.1  RemoveScrollTableEntry 

RemoveScroUTableEntry  removes  an  entry,  e,  from  a  table,  specified  by  defn,  and  discards 
it.  The  function  call  is  RemoveScrollTableEntry(defn,  e).  Table  2.22-79  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

defn 

register  pointer  to 
ScrollTableFieldDefn 

Development:SIMNET  :libmac; 
scroll,  h 

e 

register 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ilibmac; 
scroll. h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

savePort 

GrafPlr 

DevelopmentTHINK  C: 

Mac  #jncludes;Quickdraw.h 

row 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

r 

Reel 

Development.THINK  C: 

Mac  #includes:MacTypes.h 

BBN  Systems  and  Technologies 


MCCCSCI 


1  Calls  1 

Function 

Where  Described 

OisposHandte 

Standard  MerTX)ry  Manaoer  function  for  Macintosh. 

Get  Port 

Standard  Quickdraw  function  for  Macintosh. 

Set  Port 

Standard  Quickdraw  function  for  Macintosh. 

SetCtIMax 

Standard  Control  Manaoer  function  for  Macintosh. 

InvalRect 

Standard  Window  Manaoer  function  for  Macintosh. 

ScrollTableEntrvToRow 

See  Section  2.22.1.34.2. 

NextPrev 

Macro  defined  in  remove.c  in  Section  2.22.1.28. 

PrevNext 

Macro  defined  in  remove.c  in  Section  2.22.1.28. 

Calls 

Function 

Where  Described 

EmptyScrollTable 

See  Section  2.22.1.28.2. 

Table  2.22-79  RemoveScrollTableEntry  Information. 
2.22.1.28.2  EmptyScrollTable 

EmptyScroUTable  removes  all  entries  from  a  scrolling  table,  defn.  The  function  call  is 
EmptyScrollTable(defn).  Table  2.22-80  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

register  pointer  to 
ScrollTableFieldDefn 

Development:SIMNET;libmac. 

scroll.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

e 

register 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ilibmac; 
scroll.h 

1  Calls  1 

Function 

Where  Described 

RemoveScrollTableEntry 

See  Section  2.22.1.28.1. 

Table  2.22-80  EmptyScrollTable  Information. 

2.22.1.29  scroll. h 

Development:SIMNET:libmac;scroll.h 

scroll.h  is  the  header  file  associated  with  the  following  files  which  collectively  provide 
support  for  scrolling  tables  within  dialog  boxes. 
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2.22.1.30  scroll. c 

Development:SIMNET:libmac:scroll.c 


scroll.c  contains  routines  for  creating  and  discarding  scrolling  tables.  Table  2.22-81 
describes  the  variables  used  by  scroll.c. 


1  Variables  I 

Variable 

!VDe 

Where  !vDedef  Declared 

DrawScroll!able() 

extern  pascal  void 

Table  2.22-81  scroll.c  Variable  Information. 

2.22.1.30.1  ShowScrollTable 

ShowScroUTable  prepares  a  scrolling  table  field,  specified  by  d^n,  of  a  new  dialog  box, 
dialog.  The  function  call  is  ShowScrollTablefdialog,  defn).  Table  2.22-82  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


dialog 


Parameters 


e 


pointer  to  DialogState 


register  pointer  to 
Scroll!  ableFieldDefn 


Where  Tvoedef  Declared 


Development'.SIMNET  :libmac: 
dialoa.h 


Development;SlMNET  ;libmac: 
scroll. h 


Internal  Variables 

Variable 

Where  !ypedef  Declared 

save  Port 

GrafRr 

DevelopmentTHINK  C; 

Mac  #includes;Quickdraw.h 

col 

register  pointer  to 

Scroll!  ableColunDef  n 

Development.SIMNE!  :libmac: 
scroll.h 

c 

short 

Standard  C  type. 

w 

short 

Standard  C  type. 

hSize 

short 

Standard  C  type. 

vSize 

short 

Standard  C  type. 

theitem 


Handle 


Scroll!  able  EntryHandle 


Standard  C  type. 


DevelopmentTHINK  C: 
Mac  #includes:Mac!vc>es.h 


DevelopmentTHINK  C: 
Mac  #includes:Mac!vDes.h 


Development:SlMNE!  :libmac; 
scroll.h 
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1  Calls  1 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

TextSize 

Standard  Quickdraw  function  for  Macintosh. 

GetFontInfo 

Standard  Quickdraw  function  for  Macintosh. 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

SetOltem 

Standard  Dialog  Manager  function  for  Macintosh. 

NewControl 

Standard  Control  Manager  function  for  Macintosh. 

NewHandle 

Standard  Menx>ry  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

ShowDiaiog 

See  Section  2.22.1.11.1. 

Table  2.22-82  ShowScrollTable  Information. 


2.22.1.30.2  DisposeScrollTable 


DisposeScrollTable  discards  the  storage  occupied  by  a  scrolling  table,  defn.  The  function 
call  is  DisposeScrollTable(defn).  Table  2.22-83  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

dein 

register  pointer  to 
ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac: 
scroll,  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

el 

register 

ScrollTableEntrvHandle 

Development:SIMNET  libmac; 
scroll. h 

e2 

register 

ScrollTableEntrvHandle 

Development:SIMNET  ilibmac; 
scroll,  h 

1  Calls  1 

Function 

Where  Described 

DisposHandle 

Standard  Memorv  Manager  function  for  Macintosh. 

DisposeControl 

Standard  Control  Manager  function  for  Macintosh. 

Table  2.22-83  DisposeScrollTable  Information. 


2.22.1.31  scrolldraw.c 

Development:S  IM  NET :  libmac :  scrolldraw.c 

scrolldraw.c  contains  routines  for  drawing  scrolling  tables. 
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2.22.1.31.1  UpdateScrollTableEntry 


UpdateScrollTableEntry  forces  a  redraw  of  an  entry,  entry,  in  a  scrolling  table,  specified  by 
d^n.  The  function  call  is  UpdateScrollTableEntry (defn,  entry).  Table  2.22-84  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrotITableFieldDefn 

Development:SIMNET  rlibmac: 
scroll.h 

entry 

ScrollTableEntryHandle 

DevelopmentiSIMNET  :libmac; 
scroll.h 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

row 

int 

Standard  C  type. 

savePort 

GrafRr 

DevelopmentTHINK  C: 

Mac  #includes;Ouickdraw.h 

box 

Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

1  Calls  1 

Function 

Where  Described 

Scroll!  ableEntrvToRow 

See  Section  2.22.1.34.2. 

ScrollTableRowRect 

See  Section  2.22.1.34.3. 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

InvalRect 

Standard  Window  Manaqer  function  for  Macintosh. 

Table  2.22-84  UpdateScrollTableEntry  Information. 


2.22.1.31.2  DrawScrollTable 


DrawScrollTable  draws  a  scrolling  table  field  of  a  dialog  box.  The  function  call  is 
DrawScrollTable(w,  itemNo).  Table  2.22-85  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

w 

WindowRr 

Development. THINK  C: 

Mac  #includes;WindowMQr.h 

itemNo 

int 

Standard  C  type. 

Function _ Where  Described 

DrawScrollTableC _ SeeSection  2.22.1 .31 .3. 


Table  2.22-85  DrawScrollTable  Information. 
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2.22.1.31.3 


DrawScrollTableC 


DrawScrollTableC  draws  a  scrolling  table  field  of  a  dialog  box.  The  function  call  is 
DrawSciollTableC(defn).  Table  2.22-86  describes  the  parameters  used  and  functions 
called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

GetPenState 

Standard  Quickdraw  function  for  Macintosh. 

PenNormal 

Standard  Quickdraw  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Madntosh. 

TextSize 

Standard  Quickdraw  function  for  Macintosh. 

TextFace 

Standard  Quickdraw  function  for  Macintosh. 

Erase  Rect 

Standard  Quickdraw  function  for  Macintosh. 

InsetRect 

Standard  Quickdraw  function  for  Macintosh. 

FrameRect 

Standard  Quickdraw  function  for  Macintosh. 

CallPascalL 

MoveTo 

Standard  Quickdraw  function  for  Macintosh. 

PenPat 

Standard  Quickdraw  function  for  Macintosh. 

Line 

Standard  Quickdraw  function  for  Macintosh. 

DrawStrina 

Standard  Quickdraw  function  for  Macintosh. 

LineTo 

Standard  Quickdraw  function  for  Macintosh. 

HLock 

Standard  Memory  Manaaer  function  for  Macintosh. 

RectinRan 

Standard  Quickdraw  function  for  Macintosh. 

HUnlock 

Standard  Memory  Manaaer  function  for  Macintosh. 

SetPenState 

Standard  Quickdraw  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

OrawScrollTable 

See  Section  2.22.1.31.2. 

ScrollT  ableBoxScroll 

See  Section  2.22.1.32.7. 

Table  2.22-86  DrawScroIlTableC  Information. 


2.22.1.31.4  HiliteScrollTableSelection 

HiliteScrollTableSelection  is  a  hilite  function  that  inverts  a  row.  tfe/n  is  the  pointer  to 
ScrollTable;  entry  is  the  entry  of  ScrollTable;  box  is  the  coordinates  of  ScrollTable  entry 
box  to  be  hilited.  The  function  call  is  HiliteScrollTableSelection(defn,  entry,  box).  Table 
2.22-87  describes  the  parameters  used  and  function  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  :libmac; 
scroll.h 

entry 

ScrollT  ableEntryHandle 

DevelopmentiSIMNET  :libmac; 
scroll.h 

box 

pointer  to  Rect 

Development:THINK  C: 

Mac  #includes;MacTvpes.h 

1  Calls  1 

Function 

Where  Described 

InvertRect 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.22-87  HiliteScrollTableSelection  Information. 
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2.22.1.32  scrollevt.c 
Development:SIMNET:libmac:scrollevtc 


scrollevLc  contains  routines  fcH*  handling  events  related  to  scrolling  tables.  Table  2.22-88 
describes  the  variables  used  by  scrollevt.c. 


1  Variables  I 

Variable 

Where  Tvoedef  Declared 

scrollDefn 

pointer  to 

^rollT  ableFieldDefn 

DevelopmentrSIMNET  Mibrnac: 
scroll.h 

Table  2.22*88  scrollevt.c  Variable  Information. 
2.22.1.32.1  ScrollTabieActivate 

ScrollTableActivate  handles  an  activate  event  in  a  scrolling  table.  The  tunction  call  is 
ScrollTableActivate(defn,  theEvent).  Table  2.22-89  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

defn 

register  pointer  to 
ScrollTableFieldDefn 

DevelopmentrSIMNET  tlibmac; 
scroll.h 

theEvent 

pointer  to  EventRecord 

DevekjpmentrTHINK  C: 

Mac  #includes:EventMgr.h 

Internal  Variables 

Variable 

Type 

Where  Tvoedef  Declared 

savePort 

GrafRr 

DevelopmentrTHINK  C; 

Mac  #includes:Quickdraw.h 

1  Calls  1 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

InvalRect 

Standard  Window  Manager  function  for  Macintosh. 

ShowControl 

Standard  Control  Manager  function  for  Macintosh. 

HideControl 

Standard  Control  Manager  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

DialoqEvent 

See  Section  2.22.1.11.4. 

Table  2.22-89  ScrollTableActivate  Information. 
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2.22.1.32.2  ScroUTableEvent 


ScrollTableEvent  handles  a  mouse-down  event  in  a  scrolling  table.  The  function  call  is 
ScrollTableEvent(defn,  theEvent).  Table  2.22-90  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

register  pointer  to 
ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac; 
scroll.h 

theEvent 

pointer  to  EventRecord 

DevelopmentiTHINK  C: 

Mac  #includes;EventMar.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

P 

Point 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvpes.h 

i 

int 

Standard  C  type. 

box 

Rect 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTypes.h 

1  Calls  1 

Function 

Where  Described 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

GlobalToLocal 

Standard  Quickdraw  function  for  Macintosh. 

ScrollT  ableScrollBarEvent 

See  Section  2.22.1.32.3. 

1  Called  By  1 

Function 

Where  Described 

DialogEvent 

See  Section  2.22.1.11.4. 

Table  2.22-91  ScrollTableEvent  Information. 


2.22.1.32.3  ScrollTa  bleScrollBarE  ven  t 


ScrollTableSctollBarEvent  handles  a  mouse-down  in  the  scroll  bar.  The  function  call  is 
ScrollTableScrollBarEvent(defn,  where).  Table  2.22-92  describes  the  parameters  used  and 
functions  called  using  this  function. 

_ _ Parameters _ _ 

Parameter  [Type  [Where  Typedef  Declared" 

defn  register  pointer  to  Development:SIMNET;libmac: 

_ ScrollT  ableFieldPefn _ scroll.h _ 

where  Point  Development:THINK  C: 

Mac  #includes:MacTypes.h 

_  Internal  Variables  _ 

Variable  Type  Where  Typedef  Declared 

theControl  ControlHandle  DevelopmentiTHINK  C; 

Mac  #includes:ControlMqr.h 
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1  Calls  1 

Function 

Where  Described 

FindControl 

Standard  Control  Manager  function  for  Macintosh. 

TrackControl 

Standard  Control  Manager  function  for  Madntosh. 

ScrollTablePaae 

SeeSection  2.22.1.32.6. 

ScrollT  ableBoxScroll 

See  Section  2.22.1.32.7. 

Called  By 

Function 

Where  Described 

ScrollTable  Event 

See  Section  2.22.1.32.2. 

Table  2.22-92  ScrollTableScrollBarEvent  Information. 
2.22.1.32.4  ScrollTableUp 

ScrollTableUp  is  called  from  TrackControl  while  the  up-arrow  is  moused.  theControl 
points  to  the  scroll  control;  partCode  says  whether  the  mouse  was  hit  in  the  up-arrow 
section  of  the  control.  The  function  call  is  ScrollTableUp(theControl,  partCode).  Table 
2.22-93  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

theControl 

ControlHandle 

DevelopmentTHINK  C: 

Mac  #includes;ControlMgr.h 

partCode 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SetCtIValue 

Standard  Control  Manager  function  for  Macintosh. 

ScrollT  ableBoxScroll 

See  Section  2.22.1.32.7. 

Table  2.22-93  ScrollTableUp  Information. 
2.22.1.32.5  ScrollTableDown 

ScrollTableDown  is  called  from  TrackControl  while  the  down-arrow  is  moused.  The 
function  call  is  ScrollTableDown(theControl,  partCode).  Table  2.22-94  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

theControl 

ControlHandle 

DevelopmentiTHINK  C: 

Mac  #includes:ControlMgr.h 

partCode 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SetCtIValue 

Standard  Control  Manager  function  for  Macintosh. 

ScrollT  ableBoxScroll 

See  Section  2.22.1.32.7. 

Table  2.22-94 


ScrollTableDown  Information. 
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2.22.1.32.6  ScrollTablePage 


ScrollTablePage  scrolls  the  table  by  a  page.  The  function  call  is 
ScrollTablePageCpartCode).  Table  2.22-95  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

partCode 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

r 

pointer  to  Rect 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

i 

int 

Standard  C  type. 

where 

Point 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

Calls 

Function 

Where  Described 

GetMouse 

Standard  Toolbox  Event  Manaoer  function  for  Macintosh. 

TestControl 

Standard  Control  Manager  function  for  Macintosh. 

SetCtIValue 

Standard  Control  Manager  function  for  Macintosh. 

GetCtIValue 

Standard  Control  Manager  function  for  Macintosh. 

Scroll!  ableBoxScroll 

See  Section  2.22.1.32.7. 

StillDown 

Standard  Toolbox  Event  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

ScrollTableScrollBarEvent 

See  Section  2.22.1.32.3. 

Table  2.22-95  ScrollTablePage  Information. 


2.22.1.32.7  ScrollTableBoxScroll 


ScrollTableBoxScroll  redraws  a  scrolled  table.  The  function  call  is 
ScrollTableBoxScroll(defn).  Table  2,22-96  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameter 


defn 


Variable 


oldTooRow 


box 


tempRgn 


Parameters 


register  pointer  to 
ScrollTableFieldDefn 


Internal  Variables 


e 


RgnHandle 


Where  Tvpedef  Declared 


Development:SIMNET  ;libmac: 
scroll. h 


Where  Tvoedef  Declared 


Standard  C  t 


Development:THINK  C: 
Mac  #includes;MacTvpes.h 


Development:THINK  C: 
Mac  #includes;Quickdraw.h 
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1  Calls  1 

Function 

Where  Described 

QetCtIValue 

Standard  Control  Manaaer  function  for  Macintosh. 

NewRon 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

ScrollRect 

Standard  Quickdraw  function  for  Macintosh. 

InvalRan 

Standard  Window  Manaaer  function  for  Macintosh. 

BeainUDdate 

Standard  Window  Manaaer  function  for  Macintosh. 

DrawScrollTableC 

See  Section  2.22.1.31.3. 

EndUpdate 

Standard  Window  Manaaer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

ScrollT  ableScrollBarEvent 

See  Section  2.22.1.32.3. 

ScrollTableUo 

See  Section  2.22.1.32.4. 

ScrollTableDown 

See  Section  2.22.1.32.4. 

ScrollTablePaae 

See  Section  2.22.1.32.6. 

Select  ScrollTableEntrv 

See  Section  2.22.1.37.1. 

Table  2.22-96  ScroIlTableBoxScroll  Information. 


2.22.1.33  scrollmap.c 

Development;SIMNET  rlibmacrscrollmap.c 


scrollmap.c  contains  a  routine  that  invokes  a  specified  function  on  each  entry  in  a  scrolling 
table. 


2.22.1.33.1 


MapScroIlTableSelected 


MapScrollTableSelected  calls  a  supplied  function  for  each  selected  entry  in  a  scrolling  table. 
defn  is  a  pointer  to  the  structure  of  scroll  table;  inc  points  to  a  function  to  call  for  each 
selection;  backward  is  true  if  selection  extends  backwards.  The  function  call  is 
MapScrollTableSelected(defn,  fnc,  backward).  Table  2.22-97  describes  the  parameters 
used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollT  able  FieldDef  n 

DevelopmentiSIMNET  :libmac: 
scroll.h 

(fnc)() 

pointer  to  function  that  returns 
int 

Standard  C  type 

backward 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

entry 

ScrollT  ableEntryHandle 

Development:SIMNET  ilibmac; 
scroll.h 

selection 

ScrollTableEntryHandle 

Development:SIMNET  :libmac: 
scroll.h 

i 

int 

Standard  C  type. 

Table  2.22-97  MapScrollTableSelected  Information 
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2.22.1.34  scrollrow.c 

Development:SIMNET:libmac:scrollrow.c 


MCCCSCI 


scrollrow.c  contains  routines  for  mapping  between  scrolling  table  entries  and  the  rows  at 
which  they  are  displayed. 


2.22.1.34.1 


ScrollTableRowToEntry 


ScrollTableRowToEntry  maps  a  table  row  number  to  an  entry.  The  function  call  is 
ScrollTableRowToEntry (defn,  row).  Table  2.22-98  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 

Parameter 

Where  Tvpedef  Declared 

defn 

pointer  to 

Scroll! ableFieldDef  n 

Development:SIMNET  ilibmac; 
scroll.h 

row 

int 

Standard  C  type. 

Variable 


e 


Internal  Variables 


e 


register 

ScrollTableEntryHandle 


iBn 


Where  Tvpedef  Declared 


Devetopment:SIMNET  :libmac: 
scroll.h 


Return  Value 


Return  Values 


e 


Scroll!  ableEntrvHandle 


ScrollTableEntryHandle 


Meanin 


Unsuccessful 


Handle  of  ent 


Called  B 


Function  1 

Where  Described 

Select  ScrollTableEnt 

a: _ 

See  Section  2.22.1.37.1. 

Table  2.22-98  ScrollTableRowToEntry  Information. 
2.22.1.34.2  ScrollTableEntryToRow 

ScrollTableEntryToRow  maps  an  entry  to  a  table  row  number.  If  the  entry  is  not 
displayed,  -1  is  returned.  The  function  call  is  ScrollTableEntryToRow(defn,  e).  Table 
2.22-99  describes  the  parameters  used  by  this  function. 


Parameter 


defn 


Parameters 


e 


pointer  to 

ScrollTableFieldDefn 


ScrollTableEntryHandle 


Where  Typedef  Declared 


Development;SIMNET  ;libmac: 
scroll.h 


Development:SIMNET  :libmac: 
scroll.h 


Variable 


row 


Internal  Variables 


e 


Where  Tvpedef  Declared 


Standard  C  t 
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1  Return  Values  I 

Return  Value 

Type 

Meaning 

row 

int 

Table  row  number. 

-1 

int 

Entry  not  displayed. 

Called  By 

Function 

Where  Described 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

RemoveScrollTableEntrv 

See  Section  2.22.1.28.1. 

UpdateScrollT  able  Entry 

See  Section  2.22.1.31.1. 

ZoomScrollTableEntry 

See  Section  2.22.1.36.1. 

SetScrollT  ableSelection 

See  Section  2.22.1.37.2. 

Table  2.22-99  ScrollTableEntryToRow  Information. 
2.22.1.34.3  ScrollTableRowRect 

ScrollTableRowRect  computes  a  rectangle  surrounding  a  row  of  a  table.  The  function  call 
is  ScrollTableRowRect(defn,  row.box).  Table  2.22-100  describes  the  parameters  used  by 
this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development;SIMNET  ;libmac; 
scroll. h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

1  Called  By  I 

Function 

Where  Described 

UodateScrollTableEntry 

See  Section  2.22.1.31.1. 

ZoomScrollTableEntry 

See  Section  2.22.1.36.1. 

InvertScrollTable  Row 

See  Section  2.22.1.37.4. 

Table  2.22-100  ScrollTableRowRect  Information. 

2.22.1.35  scrollto.c 

Development:  SIMNET :  libmac :  scrollto.c 

scrollto.c  contains  a  routine  for  scrolling  a  table  to  bring  a  particular  row  into  view. 

2.22.1.35.1  ScrollToShow 

ScrollToShow  scrolls  a  table  to  show  a  particular  entry.  It  returns  the  new  row  number  of 
the  entry,  after  any  necessary  scrolling.  The  function  call  is  ScrollToShow(defn,  entry). 
Table  2.22-101  describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

Scroll! ableFieldDef  n 

DevelopmentiSIMNET  ilibmac: 
scroil.h 

entry 

register 

ScrollTableEntryHandle 

Development:SIMNET  ;libmac: 
scroil.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

newTop 

register  short 

Standard  C  type. 

n 

register  short 

Standard  C  type. 

maxTop 

short 

Standard  C  type. 

savePort 

GrafPtr 

DevelopmentiTHINK  C; 

Mac  #includes;Quickdraw.h 

Return  Values 

Return  Value 

Type 

Meaning 

n-defn->topRow 

int 

New  row  number  of  entry. 

Calls 

Function 

Where  Described 

SetCtIValue 

Standard  Control  Manager  function  for  Macintosh. 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

InvalRect 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.22-101  ScrollToShow  Information. 


2.22.1.36  scrollzoom.c 

Development:SIMNET:libmac:scrollzoom.c 

scrollzoom.c  contains  a  routine  for  "zoom"  animating  between  a  scrolling  table  entry  and  a 
pop-up  window  representing  its  contents. 

2.22.1.36.1  ZoomScrollTableEntry 

ZoomScrollTableEntry  zooms  between  a  table  entry  and  a  pop-up  window,  defn  is  a 
pointer  to  scroll  table  definition;  entry  is  the  entry  that  pop-up  will  describe;  window  is  a 
pointer  to  a  pop-up  window;  zoomUp  is  true  if  the  pop-up  window  should  be  on  top  and 
false  if  the  scroll  table  should  be  on  top.  The  function  call  is  ZoomScrollTableEniry(defn, 
entry,  window,  zoomUp).  Table  2.22-102  describes  the  parameters  used  and  functions 
call^  using  this  function. 


Parameters 

Parameter 

Where  !ypedef  Declared 

defn 

pointer  to 

Scroll! ableFieldDef  n 

DevelopmentiSIMNE!  ilibmac: 
scroil.h 

entry 

register 

Scroll!ableEntryHandle 

DevelopmentiSIMNE!  ilibmac; 
scroil.h 

window 

WindowRr 

Development:!HINK  C: 

Mac  #includes:WindowMgr.h 

zoomUp  I  int  I  Standard  C  type. 

_ Internal  Variables _ 
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Variable 


row 


box 


Where  Tvpedef  Declared 


Standard  C  t 


Development:THINK  C: 
Mac  #includes:MacTyDes.h 


Function 


Hide  Window 


ScrollT  ableEntrvToRow 


Scroll! able  RowRect 


ZoomTo  Window 


Show  Window 


Calls 


Where  Described 


Standard  Window  Manaoer  function  for  Macintosh. 


See  Section  2.22.1.34.2. 


See  Section  2.22.1.34.3. 


See  Section  2.22.1.47.4. 


Standard  Window  Manaoer  function  for  Macintosh. 


Table  2.22*102  ZoomScrollTableEntry  Information. 

2.22.1.37  select. c 

Developnient:SIMNET:libmac:select.c 

select.c  contains  routines  for  processing  mouse  events  in  a  scrolling  table. 


2.22.1.37.1 


SelectScrollTableEntry 


SelectScrollTableEntry  is  called  when  the  mouse  is  depressed  within  a  scrolling  table,  defn 
is  a  pointer  to  scroll  table  structure;  row  is  the  row  of  the  scroll  table  that  was  pressed; 
modifiers  indicates  which,  if  any,  keys  were  pressed  at  the  same  time  as  the  mouse  down. 
The  function  call  is  SelectScrollTableEntry(defn,  row,  modifiers).  Table  2.22-103 
describes  the  parameters  used,  errors  returned  and  functions  call^  using  this  function. 


1116 


BBN  Systems  and  Technologies 


MCC  CSCI 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

entry 

register 

ScrollTableEntryHandle 

DevelopmentiSIMNE!  ;libmac; 
scroll.h 

el 

Scroll!  ableEntryHandle 

DevelopmentiSIMNE!  :libmac: 
scroll.h 

min  Extent  Entry 

Scroll!  able  EntryHandle 

Development:SIMNE!  :libmac; 
scroll.h 

maxExtentEntry 

Scroll! able  EntryHandle 

DevelopmentiSIMNE!  :libmac: 
scroll.h 

sense 


inSelection 


oldInSelection 


mmExlentRow 


maxExtentRow 


oriainalRow 


Kmit 


Pt 


Standard  C  type. 


Standard  C  type. 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


DevelopmentiTHINK  C; 
Mac  #includes:MacTypes.h 


Function 


ScrollTableRowToEnt 


SetScrollT  ableSelection 


Invert  Scroll! able  Row 


StillOown 


GetMouse 


GetCtIMin 


SetCtIValue 


Scroll!  ableBoxScroll 


Calls 


Where  Described 


See  Section  2.22.1.34.1. 


See  Section  2.22.1.37.2. 


See  Section  2.22.1.37.4. 


Standard  !oolbox  Event  Manaoer  function  for  Macintosh. 


Standard  !oolbox  Event  Manaoer  function  for  Macintosh. 


Standard  Control  Manaoer  function  for  Macintosh. 


Standard  Control  Manaoer  function  for  Macintosh. 


See  Section  2.22.1.32.7. 


Table  2.22-103  SelectScrollTableEntry  Information. 


2.22.1.37.2 


SetScrollTableSelection 


SetScroUTableSelection  sets  the  current  selection  to  a  particular  entry.  The  function  call  is 
SetScrollTableSelection(defn,  entry).  Table  2.22-104  describes  the  parameters  used, 
errors  returned  and  functions  called  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

defn 

register  pointer  to 
Scroll!ableFieldDefn 

Development:SIMNE!  :libmac; 
scroll.h 

entry 

Scroll!  ableEntryHandle 

DevelopmentiSIMNE!  ilibmac; 
scroll.h 

Variable 


row 


IDT^ 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard  C  type. 


1117 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Calls  1 

Function 

Where  Described 

CancelScrollTableSelection 

See  Section  2.22.1.37.3. 

ScrollT  able  EntrvTo  Row 

See  Section  2.22.1.34.2. 

InvertScrollT able  Row 

See  Section  2.22.1.37.4. 

Called  By 

Function 

Where  Described 

Select  ScrollTableEntry 

See  Section  2.22.1.37.1. 

Table  2.22-104  SetScrollTableSelection  Information. 


2.22.1.37.3  CancelScrollT  ableSelection 


CancelScrollTableSelection  cancels  any  current  selections  in  a  scrolling  table,  d^n.  The 
function  call  is  CancelScrollTableSelection(defn).  Table  2.22-105  describes  the  parameters 
used,  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

register  pointer  to 
ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac: 
scroll,  h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

e 

register 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ;libmac: 
scroll,  h 

row 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

1  nvertScroIlT able  Row 

See  Section  2.22.1.37.4. 

1  Called  Bv  1 

Function 

Where  Described 

SetScrollT  ableSelection 

See  Section  2.22.1.37.2. 

Table  2.22-105  CancelScrollTableSelection  Information. 


2.22.1.37.4  InvertScrollTableRow 


InvertScrollTableRow  inverts  the  hiliting  of  a  scrolling  table  row.  The  function  call  is 
InvertScrollTableRow(defn,  row).  Table  2.22-106  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll. h 

row 

int 

Standard  C  type. 
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Internal  variables 


Variable 


saveport 


GrafPtr 


Where  Tyoedef  Declared 


Development;THINK  C: 
Mac  #includes;Quickdraw.h 


Developmenf.THINK  C; 
Mac  #includes:MacTypes.h 


Calls 

Function 

Where  Described 

ScrollT able  RowRect 

See  Section  2.22.1.34.3. 

Get  Port 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

InvertRect 

Standard  Quickdraw  function  for  Macintosh. 

Function 


Select  ScrollTableEnt 


SetScrollTableSelection 


CancelScrollTableSelection 


Called  B 


Where  Described 


See  Section  2.22.1.37.1. 


See  Section  2.22.1.37.2. 


See  Section  2.22.1.37.3. 


Table  2.22-106  InvertScrollTableRow  Information. 


2.22.1.37.5 


FirstScrollTableSelection 


FirstScroUTableSelection  returns  the  handle  to  the  first  selected  entry  in  a  scrolling  table. 
The  function  call  is  FirstScroUTableSelectionfdefn).  Table  2.22-107  describes  the 
parameters  used  by  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  ilibmac; 
scroll.h 

Variable 


e 


Internal  Variables 


e 


register 

ScrollTableEntrvHandle 


Where  Typedef  Declared 


Development;SIMNET  ilibmac; 
scroll.h 


Return  Value 


Return  Values 


Type 


ScrollTableEntrvHandle 


ScrollTableEnt  ryHandle 


Meaning 


No  selected  ent 


Handle  of  selected  entry. 


Table  2.22-107  FirstScrollTableSelection  Information. 
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2.22.1.37.6  RemoveScrollTableSelected 

RemoveScroUTableSelected  removes  currently  selected  entries  from  a  scrolling  table.  The 
function  call  is  RemoveScrollTableSelected(defn).  Table  2.22-108  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

defn 

register  pointer  to 
ScrollTableFieldDefn 

Development:SIMNET  :libmac; 
scroll.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

e1 

register 

ScrollTableEntrvHandle 

Development:SIMNET  ;libmac: 
scroll.h 

e2 

register 

ScrollTableEntrvHandle 

Development:SIMNET  ;libmac; 
scroll.h 

i 

int 

Standard  C  type. 

row 

int 

Standard  C  type. 

redrawTriaqered 

int 

Standard  C  type. 

r 

Rect 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

savePort 

GrafRr 

Development:THINK  C: 

Mac  #includes;Quickdraw.h 

I  Calls  I 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

Set  Port 

Standard  Quickdraw  function  for  Macintosh. 

SetCtIMax 

Standard  Control  Manaqer  function  for  Macintosh. 

SetCtIValue 

Standard  Control  Manaqer  function  for  Macintosh. 

InvalRect 

Standard  Window  Manaqer  function  for  Macintosh. 

NextPrev 

Macro  defined  in  select.c  in  Section  2.22.1 .37. 

PrevNext 

Macro  defined  in  select.c  in  Section  2.22.1.37. 

DisposHandle 

Standard  Memory  Manaqer  function  for  Macintosh. 

Table  2.22-108  RemoveScrollTableSelected  Information. 

2.22.1.38  sequence.h 

Development:SIMNET;libmac:sequence.h 

sequence.h  header  file  associated  with  the  following  file,  sequence.c(Section  2.22.1.39). 

2.22.1.39  sequence.c 

E)evelopment:SIMNET:libmac:sequence.c 

sequence.c  contains  routines  providing  sequencing  among  dialogs  with  provisions  for 
backing  up  in  a  sequence  and  taking  alternate  branches. 
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2.22.1.39.1  StartDialogSeq 

StartDialogSeq  puts  up  the  first  dialog  in  a  sequence  of  dialogs.  sStorage  is  a  pointer  to 
dialog  storage;  first  is  a  pointer  to  the  first  dialog  in  the  sequence;  terminate  is  a  function 
that  is  called  when  the  dialog  sequence  is  finished.  The  function  is  a  pointer  to 
DialogSeqState.  The  function  c^  is  StartDialogSeq(sStorage,  first,  terminate).  Table 
2.22-109  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

sStorage 

Ptr 

Development:THINK  C; 

Mac  #includes;MacTvpes.h 

first 

pointer  to  DialogNodeDefn 

Development:SIMNET  :libmac: 
sequence. h 

(tenninate)() 

pointer  to  function  returning 
int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

state 

pointer  to  DialogSeqState 

DevelopmentiSIMNET  ;libmac: 
sequence,  h 

1  Return  Values  1 

Return  Value 

Meaning 

state 

pointer  to  DialogSeqState 

State  of  dialog  sequence. 

1  Calls  1 

Function 

Where  Described 

NewRr 

Standard  Memory  Manager  function  for  Macintosh. 

ShowDialogSeqNode 

See  Section  2.22.1.39.2. 

Table  2.22-109  StartDialogSeq  Information. 


2.22.1.39.2  ShowDialogSeqNode 

ShowDialogSeqNode  puts  up  a  dialog  box  in  the  context  of  a  sequence  of  dialog  boxes. 
state  is  the  structure  defining  the  state  of  this  sequence;  node  is  the  current  node  in  this 
sequence.  The  function  call  is  ShowDialogSeqNode(state,  node).  Table  2.22-1 10 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

state 

pointer  to  DialogSeqState 

DevelopmentiSIMNET  ilibmac: 
sequence. h 

node 

pointer  to  DialogNodeDefn 

DevelopmentiSIMNET  ;libmac: 
sequence. h 

1  Calls  1 

Function 

Where  Described 

ShowDialoq 

See  Section  2.22.1.11.1. 

Show  Window 

Standard  Window  Manager  function  for  Macintosh. 

SetWRefCon 

Standard  Window  Manager  function  for  Macintosh. 

1 
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1  Called  Bv  1 

Function 

Where  Described 

StartDialoaSeq 

See  Section  2.22.1.39.1. 

Table  2.22-110  ShowDialogSeqNode  Information. 
2.22.1.39.3  DialogSeqEvent 

DialogSeqEvent  handles  an  event  in  a  dialog  box  member  of  a  sequence.  The  function  call 
is  DialogSeqEvent(window,  theEvent).  Table  2.22-1 1 1  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

window 

WindowRr 

DevelopmentiTHINK  C; 

Mac  #includes;WindowMqr.h 

theEvent 

pointer  to  EventRecord 

DevetopmentTHINK  C: 

Mac  #includes;EventMqr.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogSeqState 

DevelopmentiSIMNET  :libmac; 
sequence. h 

itemNo 

int 

Standard  C  type. 

nextNode 

pointer  to  DialogNodeDefn 

Development;SIMNET  ilibmac: 
sequence. h 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

Successful. 

Calls 

Function 

Where  Described 

DialooEvent 

See  Section  2.22.1.11.4. 

DialoqSeqNext 

See  Section  2.22.1.39.4. 

DialoqSeqPrev 

See  Section  2.22.1.39.5. 

showhelp 

See  Section  2.22.1.19.4. 

Called  Bv 

Function 

Where  Described 

DialoqSeqNext 

See  Section  2.22.1.39.4. 

DialoqSeqPrev 

See  Section  2.22.1.39.5 

Table  2.22-111  DialogSeqEvent  Information. 
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2.22.1.39.4  DialogSeqNext 


DialogSeqNext  goes  forward  in  a  dialog  sequence.  The  function  call  is 
DialogSeqNext(state,  node).  Table  2.22-1 12  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

state 

register  pointer  to 
DiatoqSeqState 

Development:SIMNET  :libmac; 
sequence. h 

node 

pointer  to  DialogNodeDefn 

Development;SIMNET  ilibmac; 
sequence. h 

1  Calls  1 

Function 

Where  Described 

ThrowDialoa 

See  Section  2.22.1.11.3. 

DialoqSeqEvent 

See  Section  2.22.1.39.3. 

1  Called  Bv  1 

Function 

Where  Described 

DialoqSeqEvent 

See  Section  2.22.1.39.3. 

Table  2.22-112  DialogSeqNext  Information. 


2.22.1.39.5  DialogSeqPrev 


DialogSeqPrev  backs  up  in  a  dialog  sequence.  The  function  call  is  DialogSeqPrev(state). 
Table  2.22-1 13  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

state 

register  pointer  to 
DialoqSeqState 

Development  :SIMNET  :libmac; 
sequence. h 

Calls 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

ThrowDialoq 

See  Section  2.22.1.11.3. 

DialoqSeqEvent 

See  Section  2.22.1.39.3. 

Called  By 

Function 

Where  Described 

DialoqSeqEvent 

See  Section  2.22.1.39.3. 

Table  2.22-113  DialogSeqPrev  Information. 
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2.22.1.40  simple.^ 

Development:SIMNET  ;libmac:simple.c 

simple.c  contains  routines  implementing  dialogs  used  to  display  informational  messages. 

2.22.1.40.1  ShowSimpleDialog 


ShowSimpleDialog  displays  a  dialog  described  by  a  DLOG  resource.  The  function  call  is 
ShowSimpleDialog(TesourceID).  Table  2.22-1 14  describes  the  parameters  used  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

resourcelD 

int 

Standard  C  type. 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

d 

DialogRr 

DevelopmentiTHINK  C: 

Mac  #includes;DialogMgr.h 

1  Return  Values  1 

Return  Value 

Meaning 

d 

DialogRr 

The  dialog  specified  by  the 
resource  id. 

1  Calls  1 

Function 

Where  Described 

GetNewDialoQ 

Standard  Dialog  Manager  function  for  Macintosh. 

LastCaution 

See  Section  2.22.1.4.3. 

SetWRefCon 

Standard  Window  Manager  function  for  Macintosh. 

Outlineltem 

See  Section  2.22.1.27.2. 

1  Called  By  I 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

ShowVersions 

See  Section  2.22.1.44.1. 

Table  2.22-114  ShowSimpleDialog  Information. 
2.22.1.40.2  SimpleDialogEvent 


SimpleDialogEvent  is  called  when  a  simple  dialog  gets  an  event.  The  function  call  is 
SimpleDialogEvent(window,  theEvent).  Table  2.22-1 15  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

window 

WindowRr 

DevelopmentTHINK  C; 

Mac  #includes:WindowMgr.h 

theEvent 

pointer  to  EventRecord 

DevelopmentTHINK  C: 

Mac  #includes:EventMor.h 

1  1 
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variable 


itemHit 


Internal  Variables 


MCC  CSCI 


Where  Tyoedef  Declared 


Standard  C  t 


Calls 


Function  Where  Described 


DialogSelect  I  Standard  Diatoa  Manager  function  for  Macintosh. 


DisposDialog  I  Standard  Dialog  Manager  function  for  Macintosh. 


SysBeep  I  Standard  Operating  System  Utility  function  for  Macintosh. 


Table  2.22-115  SimpleDialogEvent  Information. 

2.22.1.41  table.h 

Development;SIMNET:libmac:table.h 

table.h  header  file  associated  with  the  following  file,  table.cfSection  2.22.1.42). 

2.22.1.42  table.c 

Development:SIMNET:libmac:table.c 

table.c  contains  routines  implementing  fixed-length  (non-scrolling)  tables  within  dialog 
boxes. 


2.22.1.42.1 


ShowFixTable 


ShowFixTable  prepares  a  fixed  length  table  field  of  a  new  dialog  box.  The  function  call  is 
ShowFixTable(diaJog,  defn).  Table  2.22-1 16  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  OiatogState 

Development.'SiMNET.’llbmac; 
dialog. h 

defn 

register  pointer  to 
FixTableFieldOe^n 

Development:SIMNET  rlibmac: 
table.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

savePort 

GrafPlr 

Development:THINK  C: 

Mac  #includes:Quickdraw.h 

col 

register  pointer  to 

FixT  ableColumnDef  n 

Development:SIMNET  :libmac: 
table.h 

box 


theltem 


Handle 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Development.THINK  C: 
Mac  #includes:MacT 
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1  Calls  1 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

TextSize 

Standard  Quickdraw  function  for  Macintosh. 

GetFontInfo 

Standard  Quickdraw  function  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

SetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

ShowDialog 

See  Section  2.22.1.11.1. 

Table  2.22-116  ShowFixTable  Information. 

2.22.1.42.2  UpdateFixTableRow 

UpdateFixTableRow  forces  a  redraw  of  a  row  in  a  fixed-length  table.  The  functior  call  is 
UpdateFixTableRow(defn,  row).  Table  2.22-1 17  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

register  pointer  to 
FixTableFieldDefn 

Development:SIMNET  :libmac: 
table,  h 

row 

int 

Standard  C  tvpe. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

savePort 

GrafRr 

Development:THINK  C: 

Mac  #includes;Quickdraw.h 

box 

Rect 

DevelopmentTHINK  C; 

Mac  #includes:MacTypes.h 

1  Calls  1 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

InvalRect 

Standard  Window  Manager  function  for  Macintosh 

Table  2.22-117  UpdateFixTableRow  Information. 
2.22.1.42.3  FixTableEvent 

FixTableEvent  handles  a  mouse-down  event  in  a  fixed-length  table.  The  tunction  call  is 
FixTableEvent(defn,  theEvent).  Table  2.22-1 18  describes  the  parameters  u.sed  and 
functions  called  using  this  function. 
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Parameter 


defn 


theEvent 


Parameters 


e 


register  pointer  to 
FixTableFieldDefn 


pointer  to  EventRecord 


MCCCSCI 


Where  Tvpedef  Declared 


DevelopmentiSIMNET  :libmac: 
table.h 


Development:THINK  C: 
Mac  #includes:EventMar.h 


internal  Variables 


Variable 


savePort 


theltem 


GrafPtr 


int 


Handle 


Where  Tvpedef  Declared 


Development:THINK  C: 
Mac  #includes;MacTypes.h 


DevelopmentiTHINK  C: 
Mac  #includes:Quickdraw.h 


Standard  C  t 


DevelopmentiTHINK  C: 
Mac  #includes;MacTvDes.h 


Devetopment:THINK  C: 
Mac  #includes;MacTvDes.h 


Function 


GetPort 


Set  Port 


GlobalToLocal 


GetDItem 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Dialog  Manager  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

Dialog  Event 

See  Section  2.22.1.11.4. 

2.22.1.42.4 


Table  2.22-118  FixTableEvent  Information. 
DrawFixTable 


DrawFixTable  draws  a  fixed-length  table  field  of  a  dialog  box.  The  function  call  is 
DrawFixTablefw,  itemNo).  Table  2.22-1 19  describes  the  parameters  used  and  functions 
called  using  this  function. 
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Variable 


ht 


theltem 


Internal  Variables 


int 


int 


int 


int 


int 


int 


register  pointer  to 
FixTableReldDefn 


pointer  to 

FixedT  ableColumnDef  n 


Handle 


pnState 


PenState 


MCC  CSCI 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Development:SlMNET  :Ubmac: 
table,  h 


DevelopmentiSiMNET  :libmac: 
table.h 


Development:THINK  C: 
Mac  #includes:MacTvDes.h 


Development:THINK  C: 
Mac  #includes:MacTypes.h 


DevelopmentiTHINK  C: 
Mac  #includes;MacTypes.h 


Development:THINK  C: 
Mac  #includes;Quickdraw.h 


Calls 

Function 

Where  Described 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

OialogLookupField 

See  Section  2.22.1.12.1. 

GetPenState 

Standard  Quickdraw  function  for  Macintosh. 

PenNormal 

Standard  Quickdraw  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

TextFaceSize 

Standard  Quickdraw  function  for  Macintosh. 

EraseRect 

Standard  Quickdraw  function  for  Macintosh. 

InsetRect 

Standard  Quickdraw  function  for  Macintosh. 

FrameRect 

Standard  Quickdraw  function  for  Macintosh. 

MoveTo  Standard  Quickdraw  function  for  Macintosh 


PenPat  Standard  Quickdraw  function  for  Macintosh. 


Line  Standard  Quickdraw  function  for  Macintosh. 


StrinqWidth  Standard  Quickdraw  function  for  Macintosh. 


Drawstring  Standard  Quickdraw  function  for  Macintosh. 


LineTo  I  Standard  Quickdraw  function  for  Macintosh. 


SetRect  Standard  Quickdraw  function  for  Macintosh. 


SetPenState  Standard  Quickdraw  function  for  Macintosh 


Table  2.22-119  DrawFixTable  Information. 
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2.22.1.42.5 


FixTableRowRect 


FixTableRowRect  computes  a  rectangle  surrounding  a  single  row  of  a  table.  The  function 
call  is  FixTableRowRect(defn,  row,  box).  Table  2.22-120  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameters 


Parameter 


defn 


lEIT! 


register  pointer  to 
FixTableFieldDefn 


int 


register  pointer  to  Rect 


Where  Tvoedef  Declared 


Development;SIMNET;iibmac; 
table,  h 


Standard  C  t 


Development:THINK  C; 
Mac  #includes:MacTvpes.h 


Internal  Variables 


Variable 


theltem 


int 


Handle 


Where  Tvoedef  Declared 


Standard  C  t 


Development:THINK  C: 
Mac  #includes:MacTvDes.h 


Calls 


Function  Where  Described 


GetDItem  Standard  Dialoo  Manaoer  function  for  Macintosh. 


Table  2.22>120  FixTableRowRect  Information. 

2.22.1.43  titie.c 

IDevelopmentrSIMNET  :libmac:title.c 

titie.c  contains  a  routine  for  displaying  a  title  string  in  the  menu  bar. 


2.22.1.43.1 


MenuBarTitle 


MenuBarTitle  writes  a  title  string,  str,  centered,  in  the  menu  bar.  The  function  call  is 
MenuBarTitle(str).  Table  2.22-121  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameter 


str 


Parameters 


inter  to  char 


Where  Tvoedef  Declared 


Standard  C  t 


Internal  Variables 


Variable 


savePort 


screenPort 


GrafRr 


GrafPtr 


Fontinfo 


Where  Tvoedef  Declared 


Development:THINK  C: 
Mac  #includes;Quickdraw.h 


Development;THINK  C: 
Mac  #includes:Quickdraw.h 


Development:THINK  C: 
Mac  #includes;Quickdraw.h 


Development:THINK  C: 
Mac  #includes:MacTvDes.h 
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1  Calls  1 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

OpenPort 

Standard  Quickdraw  function  lor  Macintosh. 

GelFontInfo 

Standard  Quickdraw  function  for  Macintosh. 

EraseRect 

Standard  Quickdraw  function  for  Macintosh. 

^lOveTo 

Standard  Quickdraw  function  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

Drawstring 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.22-121  MenuBarTitle  Information. 

2.22.1.44  version.c 

Developinent:SIMNET  ilibmactversion.c 

version.c  contains  routines  for  displaying  a  dialog  identifying  the  versions  of  files 
comprising  the  current  application. 

2.22.1.44.1  ShowVersions 

ShowVersions  puts  up  a  dialog  listing  the  open  resource  files  and  the  version  string  from 
each.  The  function  call  is  ShowVersions().  Table  2.22-122  describes  the  functions  called 
using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

hdl 

Handle 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

i 

int 

Standard  C  type 

d 

DialogRr 

DevelopmentiTHINK  C: 

Mac  #includes;DialogMgr.h 

box 

Rect 

Development:THINK  C; 

Mac  #includes:macTypes.h 

versionsf2561 

char 

Standard  C  type. 

Calls 

Function 

Where  Described 

GetIndResource 

Standard  Resource  Manager  function  for  Macintosh. 

AppendString 

See  Section  2.22.1.44.2 

ShowSimpleDialog 

See  Section  2.22.1.40.1. 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

SetIText 

Standard  Dialog  Manager  function  for  Macintosh. 

Show  Window 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.22-122  ShowVersions  Information. 
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2.22.1.44.2  AppendString 

AppendString  appends  two  character  strings,  si  and  s2.  The  function  call  is 
AppendString(sl,  s2).  Table  2.22-123  describes  the  parameters  used  and  function  called 
using  this  function. 


Parameters 


Parameter 


S1 


S2 


IEI71! 

irs 
irs 


inter  to  char 


inter  to  char 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Calls 

Function 

Where  Described 

BlockMove 

Standard  Memory  Manaoer  function  for  Macintosh. 

Called  B 


Function 

Where  Described 

ShowVersions 

See  Section  2.22.1.44.1. 

Table  2.22-123  AppendString  Information. 

2.22.1.45  wait.c 

Envelopment:  SIMNET:libmac :  wait.c 

wait.c  contains  routines  to  put  up  alert  boxes  with  wait  messages.  Table  2.22-124 
describes  the  variables  used  by  wait.c. 


2.22.1.45.1 


Table  2.22-124  wait.c  Variable  Information. 
ShowWait 


ShowWait  puts  up  a  dialog  with  a  wait  message,  message.  The  function  call  is 
ShowWait(message).  Table  2.22-125  describes  the  parameter  used  and  functions  called 
using  this  function. 


Parameters 


Parameter 


messaoe 


inter  to  char 


Where  Tvoedef  Declared 


Standard  C  t 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

box 

Rect 

Development:THINK  C: 

Mac  #includes.MacTypes.h 

savePort 

GrafPtr 

Development;THINK  C: 

Mac  #includes:Ouickdraw.h 

buffer4096 


Standard  C  t 
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Calls 

Function 

Where  Described 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

GetCursor 

Standard  Toolbox  Utility  function  for  Macintosh. 

SetRect 


NewWindow 


GetPort 


SetPort 


TextFont 


SetRect 


TextBox 


2.22.1.45.2 


Standard  Quickdraw  function  for  Macintosh 


Standard  Window  Manaaer  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  TextEdit  function  for  Macintosh. 


Table  2.22-125  ShowWait  Information. 
ThrowWait 


ThrowWait  closes  the  dialog  window  with  the  wait  message  and  puts  up  the  arrow  cursor. 
The  function  call  is  ThrowWait().  Table  2.22-126  describes  the  functions  called  using  this 
function. 


Calls 


Function  Where  Described 


CloseWindow  Standard  Menu  Manaaer  function  for  Macintosh. 


SetCursor  Standard  Quickdraw  function  for  Macintosh. 


Table  2.22-126  ThrowWait  Information. 

2.22.1.46  window. c 

Development :  S IMNET  rlibmac :  window.c 

window.c  contains  routines  for  generic  handling  of  events  associated  with  windows. 
Table  2.22-127  describes  the  variables  used  by  window.c. 


Variables 


Variable 


menuHandler 


\WPR 


e 


ProcRr 


Where  Typedef  Declared 


DevelopmentTHINK  C; 
Mac  fincludesMacTvpes.h 


2.22.1.46.1 


Table  2.22-127  window.c  Variable  Information. 
SetMenuHandier 


SetMenuHandler  provides  a  routine,  hdler,  to  field  menu  events.  The  function  call  is 
SetMenuHandler(hdler).  Table  2.22-128  describes  the  parameter  used  by  this  function. 


Parameters 


Parameter 


hdler 


iEn3 


e 


ProcRr 


Where  Tvoedef  Declared 


DevelopmentTHINK  C: 
Mac  #includes:MacTvDes.h 


Table  2.22-128  SetMenuHandler  Information. 
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2.22.1.46.2  WindowEvent 

Window  Event  figures  out  which  window  an  event  has  occured  in,  and  calls  the  event 
handler  for  that  window.  If  the  event  represents  the  selection  of  a  menu  item,  a  long  word 
is  returned  defined  as  for  the  Toolbox  function  MenuSelect,  otherwise  zero  is  returned. 

The  function  call  is  WindowEvent(theEvent).  Table  2.22-129  describes  the  parameter  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

theEvent 

register  pointer  to 

EventRecord 

Development:THINK  C: 

Mac  #includes:EventMgr.h 

Internal  Variables 

Variable 

Where  Typedet  Declared 

menultem 

1 1  w  [•  1 1  [ 

Standard  C  type. 

window 

WindowRr 

Development:THINK  C: 

Mac  #includes;WindowMar.h 

1  Calls  1 

Function 

Where  Described 

FindWindow 

Standard  Window  Manaoer  function  for  Macintosh. 

MenuSelect 

Standard  Menu  Manaaer  function  for  Macintosh. 

SvstemClick 

Standard  Desk  Manaaer  function  for  Macintosh. 

Standard  Menu  Manaaer  function  for  Macintosh. 

FrontWindow 

Standard  Window  Manaaer  function  for  Macintosh. 

GetWRefCon 

Standard  Window  Manager  function  for  Macintosh, 

Table  2.22*129  WindowEvent  Information. 


2.22.1.47  zoom.c 

Development:SIMNET  :libmac:  zoom.c 

zoom.c  contains  routines  for  "zoom"  animating  between  a  rectangle  and  a  window.  Table 
2.22-130  describes  the  variables  used  by  zoom.c. 


1  Variables  | 

Variable 

Where  Typedef  Declared 

deskPort 

Graf  Port 

DevelopmentTHINK  C: 

Mac  #includes;Quickdraw.h 

Table  2.22-130  zoom.c  Variable  Information. 
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2.22.1.47.1 


Zoomlnit 


Zoomlnit  is  called  once  before  any  calls  to  ZoomRect.  The  function  call  is  ZoomInit(). 
Table  2.22-131  describes  the  functions  called  using  this  function. 


Variable 


savePort 


internal  Variables 


GrafPtr 


Where  Typedef  Declared 


Development:THINK  C: 
Mac  #jncludes:Quickdraw.h 


Function 


GetPort 


OoenPort 


PenPat 


PenMode 


SetPort 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Table  2.22<131  Zoomlnit  Information. 


2.22.1.47.2 


ZoomRect 


ZoomRect  is  given  two  rectangles  in  global  coordinates  and  interpolates  on  into  the  other, 
making  a  zooming  rectangle  image  on  the  screen.  The  rectangles  and  the  screen  image  are 
not  altered.  smallRect  is  the  coordinates  of  the  smaller  box;  bigRect  is  the  coordinates  of 
the  bigger  box;  zoomUp  is  true  if  zooming  from  small  box  to  big  box.  The  function  call  is 
Zoon:iRect(smallRect,  bigRect,  zoomUp).  Table  2.22-132  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameters 


Parameter 


smallRect 


bigRect 


zoomU 


pointer  to  Rect 


pointer  to  Rect 


Where  Tvoedef  Declared 


Development:THINK  C: 
Mac  #includes:MacTypes.h 


Development:THINK  C: 
Mac  #includes:MacTypes.h 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

savePort 

GrafRr 

DevelopmentiTHINK  C 

Mac  #includes;Quickdraw.h 

recti 

Rect 

Development:THINK  C; 

Mac  #includes:MacTvpes.h 

rect2 

Rect 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

rect3 

Rect 

DevelopmentiTHINK  C; 

Mac  #includes:MacTypes.h 

rect4 

Rect 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTypes.h 

tract 

Fixed 

DevelopmentiTHINK  C: 

Mac  #includesiMacTypes.h 

factor 

Fixed 

DevelopmentiTHINK  C: 

Mac  #includesiMacTypes  h 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

Set  Port 

Standard  Quickdraw  function  for  Macintosh. 

FixRatio 

Standard  Toolbox  Utility  function  for  Macintosh. 

FrameRect 

Standard  Quickdraw  function  for  Macintosh. 

SetRect 

Standard  Quickdraw  function  for  Macintosh. 

Blend 

See  Section  2.22.1.47.3. 

FixMul 

Macro  defined  in  zoom.c. 

Called  By 

Function 

Where  Described 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

Table  2.22-132  ZoomRect  Information. 


2.22.1.47.3  Blend 

Blend  interpolates  one  step  in  zooming  from  one  rectangle  to  another.  smallCoord  is  the 
coordinates  of  the  smaller  rectangle;  bigCoord  is  the  coordinates  of  the  bigger  rectangle. 
The  function  call  is  Blend(smallCoord,  bigCoord,  fract).  Table  2.22-133  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


smallCoord 


bioCoord 


fract 


Parameters 


lEin 


e 


int 


ml 


Fixed 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  type. 


Development.THINK  C; 
Mac  #includes:MacTypes.h 


Variable 


smallFix 


bigFix 


tempFix 


Internal  Variables 


e 


Fixed 


Fixed 


Fixed 


Where  Typedef  Declared 


Development:THINK  C: 
Mac  #includes;MacTypes.h 


Development.THINK  C: 
Mac  #includes:MacTypes.h 


DevelopmentiTHINK  C: 
Mac  #includes:MacTypes.h 


Return  Value 


s 


Return  Values 


Meanin 


DDP  socket  number 


Calls 

Function 

Where  Described 

FixMul 

Macro  defined  in  zoom.c. 

FixRound 

Standard  Toolbox  Utility  function  for  Macintosh. 

Called  B 


Function 

Where  Described 

ZoomRect 

See  Section  2.22.1.47.2. 

Table  2.22-133  Blend  Information. 
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2.22.1.47.4 


ZoomToWindow 


2k)omToWindow  zooms  between  a  rectangle  within  one  window  and  the  frame  of  another 
window.  The  function  call  is  2toomToWindow(windowl,  recti,  window2,  zoomUp). 
Table  2.22-134  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

window! 

WindowRr 

DevelopmentiTHINK  C: 

Mac  #includes:WindowMgr.h 

recti 

pointer  to  Rect 

Development:THINK  C: 

Mac  #tncludes;MacTvDes.h 

window2 

register  WindowPtr 

Development:THINK  C: 

Mac  #inctudes:WindowMar.h 

zoomUo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

smallRect 

Rect 

DevelopmentrTHINK  C: 

Mac  #includes:MacTvpes.h 

bigRect 

Rect 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

i 

register  int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ZoomRect 

See  Section  2.22.1.47.2. 

1  Called  1 

Function 

Where  Described 

ZoomScrollTableEntrv 

See  Section  2.22.1.36.1. 

Table  2.22-134  ZoomToWindow  Information. 


2.22.2  libsim 

Folder:  "Developnient:SIMNET:MCC:Ubsim" 

This  folder  contains  a  library  of  C  functions  supporting  the  placement  and  reconstitution  of 
vehicle  simulators.  The  libraiy-  is  used  by  both  the  SCC  and  Vehicle  Placement  Console 
Macintosh  applications.  The  library  is  composed  from  the  following  files: 


2.22.2.1  libsim. h 

Development:SIMNET:MCC:libsim:libsiin.h 

libsim. h  defines  the  external  interface  to  the  libsim  library.  T  abic  2.22-135  describes  ihe 
variables  used  by  libsim. h. 
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1  Variables  1 

Variable 

Where  Tvoedef  Declared 

terrainBounds 

extern  LongRect 

Development:SIMNET  :libmac: 
ionopth 

battleScheme 

extern  char 

Standard  C  type. 

mccForcelD 

extern  char 

Standard  C  type. 

company  Role 

extern  array  of  char 

Standard  C  type. 

simulators 

extern  array  of  SimDescriptor 

Oevelopment.'SIMNET  :MCC: 
libsim:libsim.h 

pastSimulators 

extern  array  of  SavedDefaults 

Development:SIMNET:MCC: 

libsim:libsim.h 

Table  2.22-135  libsim.h  Variable  Information. 


2.22.2.2  libsim_int.h 

Development:SIMNET:MCC:libsini:libsim_inLh 


limsim_int.h  contains  definitions  used  within  the  libsim  library.  Table  2.22-136  describes 
the  variables  used  by  libsim_int.h. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

libsimStandaloneVersion 

extern  char 

Standard  C  type. 

simulatorTypes 

extern  array  of 
SimulatorTypeData 

Development:SIMNET  ;MCC: 
libsimilibsim  int.h 

placeBuffer 

extern  SimPlaceData 

Development:SIMNET  :MCC: 
libsim.libsim  int.h 

detailBuffer 

extern  SimVehicleStatus 

DevelopmentiSIMNET  :MCC: 
include:sim_xact.h 

place  Dialog 

extern  pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

detailOialog 

extern  pointer  to  DialogState 

Development:SIMNET  ;libmac; 
dialog. h 

vehCancelField 

extern  PushButtonFieldDefn 

Development:SIMNET  ;libmac; 
dialog.h 

vehBumperField 

extern  NumberFiekJDefn 

Development:SIMNET  ;libmac: 
dialog.h 

vehBowField 

extern  NumberFieldDefn 

Development:SIMNET  ilibmac; 
dialog.h 

vehTeamAField 

extern  RBFieldDefn 

DevelopmentiSIMNET  rlibmac; 
dialog.h 

vehTeamBField 

extern  RBFieldDefn 

Development;SIMNET  ilibmac; 
dialog.h 

vehObserverField 

extern  RBFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

vehRectField 

extern  RectFieWDefn 

DevelopmentiSIMNET  ilibmac; 
dialog.h 

vehLocationFleld 

extern  CoordinatesFiekfDefn 

DevelopmentiSIMNETilibmac; 

dialog.h 

Table  2.22-136  libsim  int.h  Variable  Information. 
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2.22.2.3  atalk.c 

DevelopmentiSIMNET  :MCC:libsim:atalk.c 

atalk.c  contains  routines  for  transferring  information  about  vehicle  simulators  between  the 
MCC  host  and  a  Macintosh. 

2.22.2.3.1  DownloadSimulators 

DownloadSimulators  obtains  information  about  the  vehicle  simulators  available  for 
inclusion  in  the  exercise.  The  function  call  is  Downloads imulators().  Table  2.22-137 
describes  the  internal  variables.used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

reqister  int 

Standard  C  type. 

Sim 

register  pointer  to 
SimDescriptor 

Development;SIMNET  :MCC: 
libsimtiibsim.h 

req 

SimExistsRequest 

Development:SIMNET  ;MCC; 
include;sim  xact.h 

rsp 

Si  mExists  Response 

Development:SIMNET  ;MCC: 
include.'sim  xact.h 

tin 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

Table  2.22-137  DownloadSimulators  Information. 


2.22.2.3.2  Upload VehicleParameters 

UploadVehicleParameters  tells  the  host  about  a  vehicle  placement.  Vehicle  parameters  are 
obtained  from  the  structure  supplied.  The  function  call  is  UploadVehicleParameters(sim. 
data).  Table  2.22-138  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SimDescriptor 

Deyelopment:SlMNET  ;MCC: 
libsimilibsim.h 

data 

register  pointer  to 
SimPlaceData 

Development:SIMNET  ;MCC: 
libsimilibsim  int.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

SimlnitRequest 

Deyelopment:SIMNET  MCC; 
include:sim  xact.h 

rsp 

SimlnitResponse 

DeyelopmentiSlMNET  :MCC; 
include ;sim  xact.h 

i 

int 

Standard  C  type. 

errCode 

int 

Standard  C  type. 
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Return  Value 


1 


Return  Values 


Meanin 


Unsuccessful. 


Successful. 


Function 


ATPPut 


Poi  ntloM  apCoordi  nates 


ShowCaution 


Calls 


Where  Described 


See  Section  2.22.1.3.3. 


See  Section  2.22.1.26.2. 


See  Section  2.22.1.4.1. 


Function 


ComDieteVehicleDialo 


Called  B 


Where  Described 


See  Section  2.22.2.9.6. 


Table  2.22-138  UploadVehicleParameters  Information. 
2.22.2.3.3  DownloadVehicleParameters 

DownloadVehicleParameters  obtains  the  latest  vehicle  data  from  the  host.  The  vehicle 
parameters  are  placed  in  the  structure  supplied.  The  function  call  is 
DownloadVehicleParameters(sim,  data).  Table  2.22-139  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameter 


sim 


Parameters 


register  pointer  to 
SimDescriotor 


register  pointer  to 
SimPlaceData 


Where  Typedef  Declared 


Development:SIMNET  :MCC: 
libsim:libsim.h 


Development:SIMNET  :MCC: 
libsim:libsim  int.h 


Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

SimQueryRequest 

Development:SIMNET  :MCC: 
include.sim  xact.h 

rsp 

SimQueryResponse 

Development:SIMNET  :MCC: 
include;sim  xact.h 

Standard  C  t 


Return  Value 


1 


Return  Values 


Type 

Meaning 

int 

Unsuccessful. 

int 

Successful. 
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1  Calls  1 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 

ShowCaution 

See  Section  2.22.1.4.1. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

Called  Bv 

Function 

Where  Described 

ShowVehicleDialoQ 

See  Section  2.22.2.9.5. 

Table  2.22>139  DownloadVehicleParameters  Information. 
2.22.2.3.4  ProcessSimPlacedRequest 

ProcessSimPlacedRequest  processes  a  transaction  frcnn  the  host  indicating  that  a  simulator 
has  been  placed  by  another  console.  The  function  caU  is  ProcessSimPlacedRequest  (req). 
Table  2.22-140  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

req 

register  pointer  to 
SimPlacedRequest 

Development_SIMNET  :MCC: 
includeisim  xact.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SimDescriptor 

Development:SIMNET  ;MCC; 
libsim:libsim.h 

1  Calls  1 

Function 

Where  Described 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

Table  2.22-140  ProcessSimPlacedRequest  Information. 


2.22.2.4  data.c 

Development:SIMNET:MCC:libsim:data.c 

data.c  defines  data  structures  associated  with  the  libsim  library,  such  as  tables  of 
information  about  types  and  instances  of  vehicle  simulators.  Table  2.22- 141  de.scribes  the 
variables  used  by  data.c. 
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1  Variables  1 

Variable 

Tvoe 

Where  Tvpedef  Declared 

libsimStandaloneVersion 

char 

Standard  C  type. 

terrainBounds 

LongRect 

Development;SIMNET  :libmac; 
longpt.h 

battleScheme 

char 

Standard  C  type. 

mccForcelD 

char 

Standard  C  type. 

company  Role 

array  of 

maxNumberComDanies  char 

Standard  C  type. 

simulators 

array  of  maxVehideSimulators 
SimDescriotor 

Development:SIMNET  :MCC: 
libsim.'libsim.h 

pastSimulators 

array  of  maxVehideSimulators 
SavedDefaults 

Development:SIMNET  :MCC; 
libsim:libsim.h 

placeDialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialOQ.h 

detailDialog 

pointer  to  DialogState 

DeyelopmentrSIMNET  :libmac: 
dialog. h 

placeBuffer 

SimPlaceData 

Development:SIMNET;MCC; 
libsimilibsim  int.h 

detailBufter 

SimVehicleStatus 

Development:SIMNET  :MCC; 
include:sim  xact.h 

m1  PlaceDialog 

extern  DialogDefn 

Development:SIMNET  :libmac: 
dialog. h 

m2Place  Dialog 

extern  DialogDefn 

Development:SIMNET:libmac: 
dialog. h 

fredPlaceDialog 

extern  DialogDefn 

Development:SIMNET  ;libmac: 
dialog. h 

simulatorTypes 

anay  of  SimulatorTypeData 

DevelopmentiSIMNET  :MCC: 
libsim;libsim  int.h 

Table  2.22-141  data.c  Variable  Information. 
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2.22.2.5  fred.c 

Development:SIMNET  :MCC:libsim:fred.c 

fredx  contains  routines  implementing  a  user  interface  for  placing  or  reconstituting  a 
SIMNET  FRED  (rotary  wing  aircraft)  simulator.  Table  2.22-142  describes  the  variables 
used  by  fred.c. 


Variables 

Variable 

Where  Tvoedef  Declared 

fredPlaceOiaiog 

extern  OlalogOefn 

Development:SIMNET;|jbmac; 

dialOQ.h 

fredFuelField 

NumberFieldDefn 

DevelopmentiSIMNET  :libmac: 
dialoa.h 

fredAttack  Field 

RBFietdOefn 

Development:SIMNET  Mibrnac; 
dialOQ.h 

fredScoutField 

RBFieldDefn 

Development:SlMNET;libmac; 

dialOQ.h 

fredAmmoFields 

array  of  NumberFieldDefn 

DevelopmentiSIMNET  ilibmac; 
dialOQ.h 

IredPlaceFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialOQ.h 

fredPlaceOiaiog 

OialogDefn 

DevelopmentiSIMNET  ilibmaci 
dialOQ.h 

Table  2.22>142  fred.c  Variable  Information. 

2.22.2.5.1  FREDSetDefaults 

FREDSetDefaults  sets  the  FRED  placement  fields  to  their  default  values.  The  function  call 
is  FREDSetDefaults().  This  function  calls  only  standard  functions  and  is  not  called  by  any 
other  function  in  this  library,  so  no  table  is  included  for  it. 

2.22.2.5.2  FREDLoadSavedData 

FREDLoadSavedData  loads  the  FRED  placement  dialog  with  canned  parameters.  The 
function  call  is  FREDLoadSavedData(company,  bumper).  Table  2.22-143  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


comoan 


bumper 


Parameters 


Where  TvDedef  Declared 


Standard  C  type. 


Standard  C  type. 


Variable 


Sim 


Internal  Variables 


pointer  to  SavedDefaults 


Where  Tvpedef  Declared 


DevelopmentiSiMNET  :MCC; 
libsim:libsim.h 


Function 


FindOldSimulafor 


Calls 


Where  Described 


See  Section  2.22.2.9.9. 


See  Section  2.22.1.11.2. 
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Called  B 


Function 

Where  Described 

VehicleBumperNumber 

See  Section  2.22.2.9.7. 

Table  2.22*143  FREDLoadSavedData  Information 
2.22.2.5.3  FREDPIaceEvent 

FREDPlaceEvent  is  not  used  in  the  version  6.6  release. 


Parameters 


e 


pointer  to  OialogState 


int 


Parameter 


dialog 


lEni! 


itemNo 


Where  Tvoedef  Declared 


Oevelopment.'SIMNET  riibmac; 
dialOQ.h 


Standard  C  t 


Function 


showhel 


CheckMandatorvFields 


ComDletevehicleOialo 


Calls 


Where  Described 


See  Section  2.22.1.19.4. 


See  Section  2.22.1.13.1. 


See  Section  2.22.2.9.6. 


Table  2.22*144  FREDPIaceEvent  Information. 

2.22.2.6  load.c 

Development;SIMNET  ;MCC;libsim;load.c 

load.c  contains  routines  for  loading  "canned"  data  into  the  library's  data  structures,  to 
permit  operation  of  a  standalone,  demo  versions  of  the  SCC  and  Vehicle  Placement 
Console. 

2.22.2.6.1  LoadCannedSimulators 

LoadCannedSimulators  loads  canned  simulator  data,  for  the  demo  version.  The  parameter, 
company,  specifies  whether  the  simulators  should  be  unassigned  (if  it  is  assignedNothing) 
or  assigned  to  a  particular  company.  The  function  call  is 

LoadCannedSimulators(company).  Table  2.22-145  describes  the  parameters  used  by  this 
function. 


Parameter 


lEiTX 


Parameters 


Where  Tvoedef  Declared 


Standard  C  t 


Internal  Variables 

Variable 

Tvoe 

Where  Typedef  Declared 

ps 

register  pointer  to 

Saved  Defaults 

Development:SIMNET  :MCC: 
libsimilibsim.h 

array  of  50  char 


Standard  C  t 


Table  2.22*145  LoadCannedSimulators  Information. 
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2.22.2.7  ml.c 

Development:SIMNET  :M(X:libsim:ml  .c 

ml  .c  contains  routines  implementing  a  user  interface  for  placing  or  reconstituting  a 
SIMNET  Ml  simulator.  Table  2.22-146  describes  the  variables  used  by  ml.c. 


Variables 


Variable 


m1  Place  Dialog 


m1  DetailDialog 


fuelLoadBuffer 


aodsLoadBuffer 


heatLoadBuffer 


mIFuelField 


mlAPDSField 


mIHEATField 


ml  Maint  Fields 


m1  PlaceFieldList 


ml  Place  Dialog 


mUurretField 


m1  FuelFields 


mlAPDSFields 


mlHEATFieWs 


mlDetailFieldList 


m1  DetailDialog 


Where  Typedef  Declared 


DevelopmentiSIMNET  :libmac: 
dialoQ.h 


DevelopmentrSIMNET  ilibmac: 
dialoQ.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevetopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNETilibmac: 

dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


pointer  to  array  of  FieldDefn  DevelopmentiSIMNETilibmac: 

dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


extern  DiaiogDefn 


extern  DiaiogDefn 


mt 


mt 


mt 


NumberFieldDefn 


NumberFiekfDefn 


NumberFieldDefn 


array  of  RBFIeWDefn 


pointer  to  array  of  FieldDefn 


DiaiogDefn 


NumberFieldOefn 


array  of  NumberFieldDefn 


array  of  NumberFieldDefn 


array  of  NumberFieldDefn 


DiaiogDefn 


Table  2.22-146  ml.c  Variable  Information. 


2.22.2.7.1  MlSetDefaults 

MlSetDefaults  sets  the  Ml  placement  fields  to  their  default  values.  The  function  call  is 
MlSetDefaults().  This  function  calls  only  standard  functions  and  is  not  called  by  any  other 
function  in  this  library,  so  no  table  is  included  for  it. 
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2.22.2.7.2  MlLoadSavedData 

MlLoadSavedData  loads  the  Ml  placement  dialog  with  canned  parameters.  The  function 
call  is  MlLoadSavedData(company,  bumper).  Table  2.22-147  describes  the  parameters 
used  and  functions  called  using  this  function. 


Parameters 


Parameter 


comoan 


bumper 


Variable 


Sim 


Where  Typedef  Declared 


char 

Standard  C  t 

char 

Standard  C  t 

Internal  Variables 


e 


pointer  to  SavedDefaults 


Where  Typedef  Declared 


Development:SIMNET  :MCC: 
libsim:libsim.h 


Function 


FindOkjSimulator 


Ml  Place  Fetch 


UodateDialo 


Calls 


Where  Described 


See  Section  2.22.2.9.9. 


See  Section  2.22.2.7.4. 


See  Section  2.22.1.11.2. 


Called  B 


Function 

Where  Described 

ValidBumperNumber 

See  Section  2.22.2.9.7. 

Table  2.22-147  MlLoadSavedData  Information. 

2.22.2.7.3  MlFillDetail 

MlFillDetail  updates  the  detailed  allocation  of  fuel  and  ammunition  according  to  the  total 
fuel  and  ammunition  quantities  entered.  The  function  call  is  MlFillDetailQ.  Table  2.22- 
148  describes  the  internal  variables  used  and  functions  called  using  this  function. 


Variable 


remainderl 


remainder2 


maximum 


apdsChanaed 


heatChanoed 


ion 


Internal  Variables 


e 


reoister  int 


reoister  int 


reoister  int 


int 


int 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  tvoe. 


Standard  C  tvpe. 


Standard  C  t 


Standard  C  type. 


Function 


min 


Calls 


Where  Described 


Macro  defined  in  Development:SIMNET:MCC:libsim;ml.c. 


Called  B 


Function 

Where  Described 

MIPIaceEvent 

See  Section  2.22.2.7.5. 

Table  2.22-148  MlFillDetail  Information. 
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2.22.2.7.4  MlPlaceFetch 


MlPlaceFetch  reads  the  cuirent  values  of  the  fuel  and  ammo  load  buffers  into  the  Ml 
Placement  dialog  to  display  to  the  user.  The  function  call  is  MlPlaceFetch(dialog).  Table 
2.22-149  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

DevelopmentiSIMNET  ilibmac; 
dialog. h 

Called  By 

Function 

Where  Described 

MILoadSavedOata 

See  Section  2.22.2.7.2. 

MlDetailEvent 

See  Section  2.22.2.7.6. 

Table  2.22-149  MlPlaceFetch  Information. 


2.22.2.7.5  MlPlaceEvent 


MlPlaceEvent  fields  events  in  the  Ml  Placement  dialog.  The  function  call  is 
MlPlaceEvent(dialog,  itemNo).  Table  2.22-150  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development;SIMNET  ilibmac: 
dialog. h 

itemNo 

int 

Standard  C  type 

Calls 

Function 

Where  Described 

showhelp 

See  Section  2.22.1.19.4. 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

ShowCaution 

See  Section  2.22.1.4.1 

MIFillDetail 

See  Section  2.22.2.7.3. 

CompleteVehicleDialoq 

See  Section  2.22.2.9.6. 

ShowDialog 

See  Section  2.22.1.11.1. 

Show  Window 

Standard  Window  Manager  tunction  for  Macintosh 

Table  2,22-150  MlPlaceEvent  Information. 


2.22.2.7.6  MlDetailEvent 


MlDetailEvent  fields  events  in  the  Ml  Detail  dialog  The  function  call  is 
MlDetaiIEvent(dialog,  itemNo).  Table  2.22-151  descrines  the  parameters  used 
functions  called  using  this  funciion. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  nialog.*^'iutc- 

Devf  1  jnment:SIMNr-T;|ibrnac 
diaio  i  ii 

ItemNo 

int 

Standard  C  type. 

BBN  Systems  and  Technologies 


MCC  CSCI 


_ _ Calls _ 

Function  I  Where  Described 

showhelp _ See  Section  2.22.1  ■19.4. _ 

CheckMandatory Fields _ See  Section  2.22.1.13.1. _ 

ShowCaution _ See  Section  2.22.1 .4.1 _ 

MiPlaceFetch _ See  Section  2.22.2.7.4. _ 

UpdatePiaiog _ See  Section  2.22.1.11 .2. _ 

ThrowDialog  See  Section  2.22.1 .11 .3. 

Table  2.22-151  MlDetailEvent  Information. 

2.22.2.8  m2.c 

Development:SIMNFT:MCC:libsim:m2.c 


m2.c  contains  routi.  .  implementing  a  user  interface  for  placing  or  reconstituting  a 
SIMNET  M2/3  simulator.  Table  2.22-152  describes  the  variables  used  by  m2.c. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

m2Place  Dialog 

extern  DialogDefn 

Development'.SIMNET  :libmac: 
dialog. h 

m2DetailDjalog 

extern  DialogDefn 

Development:SIMNET  ;libmac: 
dialog. h 

fuelLoadBuffer 

int 

Standard  C  type. 

towLoadBuffer 

int 

Standard  C  type. 

m2FuelField 

NumberFieWDefn 

Development:SIMNET  :libmac: 
dialog. h 

m2BinFields 

array  of  NumberFieldDefn 

Development:SIMNET  :libmac: 
diaiog.h 

m2BinTypeFields 

array  of  RBFiekJDefn 

Development;SIMNET  :libmac; 
diaiog.h 

m2Ammo  Fields 

array  of  NumberFieldDefn 

Development:SIMNET  ilibmac: 
diaiog.h 

m2MaintFields 

array  of  RBFiekjDefn 

DevelopmentiSIMNET  ilibmac; 
diaiog.h 

m2ConfigurationFieids 

array  of  RBFiekjDefn 

DevelopmentiSIMNET  ilibmac: 
diaiog.h 

m2PlaceFieldList 

array  of  pointer  to  FiekJDefn 

Development:SIMNET  :libmac: 
diaiog.h 

m2  Place  Dialog 

DialogDefn 

DevelopmentiSIMNET  ilibmac; 
diaiog.h 

m2TurretField 

NumberFieldDefn 

Development:SIMNET  :libmac: 
diaiog.h 

m2FuelFields 

array  of  NumberFieldDefn 

DevelopmentiSIMNET  ilibmac: 
diaiog.h 

m2LauncherFields 

array  of  CBFiekJDefn 

DevelopmentiSIMNET  ilibmac: 
diaiog.h 

m2MissilFields 

array  of  NumberFieldDefn 

DevelopmentiSIMNET  ilibmac: 
diaiog.h 

m2DetailFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
diaiog.h 

m2DetailDialog 

DialogDefn 

DevelopmentiSIMNET  ilibmac: 
diaiog.h 

Table  2.22-152  m2.c  Variable  Information. 
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2.22.2.8.1  LimitCheck 


LimitCheck  is  used  to  locally  check  capacity  limits.  The  function  call  is  LimitCheck(type, 
value,  limit,  units).  Table  2.22-153  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

i  Parameter  1 

Where  Typedef  Declared 

pointer  to  char 

Standard  C  type. 

value 

int 

Standard  C  type. 

Nmit 

int 

Standard  C  type. 

units 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

but 

array  of  100  char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

Over  the  limits. 

1 

int 

Within  the  limits. 

I  Calls  I 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

I  Called  By  I 

Function 

Where  Described 

M2PlaceEvent 

See  Section  2.22.2.8.6. 

M2  Detail  Event 

See  Section  2.22.2.8.8. 

Table  2.22*153  LimitCheck  Information. 

2.22.2.8.2  M2SetDefaults 

M2SetDefaults  sets  the  M2  placement  fields  to  their  default  values.  The  function  call  is 
M2SetDefaults().  This  function  calls  only  standard  functions  and  is  not  called  by  any  other 
function  in  this  library,  so  no  table  is  included  for  it. 

2.22.2.8.3  M2LoadSavedData 

M2LoadSavedData  loads  the  M2  placement  dialog  with  canned  parameters.  The  function 
call  is  M2LoadSavedData(company,  bumper).  Table  2.22-154  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

company 

char 

Standard  C  type. 

bumper 

char 

Standard  C  type. 

BBN  Systems  and  Technologies _ MCC  CSCI 


1  Internal  Variables  1 

Variable 

Tvoe 

Where  Tvpedef  Declared 

Sim 

pointer  to  SavedDefaults 

Development:SIMNET  ;MCC: 
libsimilibsim.h 

Calls 

Function 

Where  Described 

FindOldSimulator 

See  Section  2.22.2.9.9. 

M2PlaceFetch 

See  Section  2.22.2.8.5. 

UpdateDialoo 

See  Section  2.22.1.11.2. 

Called  By 

Function 

Where  Described 

ValidBumperNumber 

See  Section  2.22.2.9.7. 

Table  2.22*154  M2LoadSavedData  Information. 


2.22.2.8.4  M2FinDetail 

M2FillDetail  updates  the  detailed  allocation  of  fuel  and  ammunition  according  to  the  total 
fuel  and  ammunition  quantities  entered.  The  function  call  is  M2FillDetail().  Table  2.22- 
155  describes  the  internal  variables  used  and  functions  called  using  this  function. 


I  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

remainder 

reqister  int 

Standard  C  type. 

I  Calls  I 

Function 

Where  Described 

min 

Macro  defined  in  Development:SIMNET:MCC:libsim:m2.c. 

I  Calied  By  I 

Function 

Where  Described 

M2PlaceEvent 

See  Section  2.22.2.8.6. 

Table  2.22-155  M2FniDetan  Information. 


2.22.2.8.5  M2PlaceFetch 

M2PlaceFetch  reads  the  current  values  of  the  fuel  and  tow  load  buffers  into  the  M2 
Placement  dialog  to  display  to  the  user.  The  function  call  is  M2PlaceFetch(dialog).  Table 
2.22-156  describes  the  parameters  used  by  this  function. 
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1  Called  By  I 

Function 

Where  Described 

M2LoadSavedData 

See  Section  2.22.2.8.3. 

M2DetailEvent 

See  Section  2.22.2.8.8. 

Table  2.22-156  M2PlaceFetch  Information. 
2.22.2.8.6  M2PlaceEvent 


M2PlaceEvent  fields  events  in  the  M2  Placement  dialog.  The  function  call  is 
M2PlaceEvent(dialog,  itemNo).  Table  2.22-157  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

DevelopmentrSIMNET  rlibmac; 
dialog. h 

itemNo 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

showhelp 

See  Section  2.22.1.19.4. 

CheckMandatorvFields 

See  Section  2.22.1.13.1. 

LimitCheck 

See  Section  2.22.2.8.1. 

ShowCaution 

See  Section  2.22.1.4.1. 

M2Fill0etail 

See  Section  2.22.2.8.4. 

CompleteVehicleDialoa 

See  Section  2.22.2.9.6. 

ShowDialog 

See  Section  2.22.1.11.1. 

Show  Window 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.22-157  M2PlaceEvent  Information. 

2.22.2.8.7  M2DetailFetch 

M2DetailFetch  reads  in  the  current  stowed  missile  limits  into  the  M2  Detail  dialog  for 
display  to  the  user.  The  function  call  is  M2DetailFetch(dialog).  Table  2.22-158  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development;SIMNET.Iibmac: 

dialog.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  1 0  char 

Standard  C  type 

Calls 

Function 

Where  Described 

SetStaticText 

See  Section  2.22.1.11.8. 

Tabic  2.22-158  M2DciailFetch  Information. 
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2.22.2.8.8  M2DetaiiEvent 

M2DetailEvent  fields  events  in  the  M2  Detail  dialog.  The  function  call  is 
M2DetailEvent(dialog,  itemNo).  Table  2.22-159  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

TvDe 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialoq.h 

itemNo 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

showhelp 

See  Section  2.22.1.19.4. 

CheckMandatorvFields 

See  Section  2.22.1.13.1. 

LimitCheck 

See  Section  2.22.2.8.1. 

ShowCaution 

See  Section  2.22.1.4.1. 

M2PlaceFetch 

See  Section  2.22.2.8.5. 

UpdateDialoq 

See  Section  2.22.1.11.2. 

ThrowDialoq 

See  Section  2.22.1.11.3. 

Table  2.22-159  M2DetailEvent  Information. 


2.22.2.9  sim.c 

Development:  SIMNET  :MCC;  libsim:  sim.c 

sim.c  contains  various  routines  supporting  dialogs  for  placing  and  reconstituting  vehicle 
simulators.  Table  2.22-160  describes  the  variables  us^  by  sim.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

currentSim 

pointer  to  SimDescriptor 

Development:SIMNET  :MCC: 
libsim:libsim.h 

vehCancelField 

PushButtonFieldDefn 

Development:SIMNET  :libmac: 
dialoq.h 

vehBumperField 

NumberFieldDefn 

Development:SIMNET  ilibmac: 
dialoq.h 

vehTeamAField 

RBFieldDefn 

Development;SIMNET  ilibmac; 
dialoq.h 

vehTeamBField 

RBFiekJDefn 

Development;SIMNET  ilibmac: 
dialoq.h 

vehObserverField 

RBFieldDefn 

Development.SIMNET.libmac. 

dialoq.h 

vehRectField 

RectFiekJDefn 

DevelopmentiSIMNET  ilibmac: 
dialoq.h 

vehLocationField 

CoordinatesFieldDefn 

DevelopmentiSIMNET  ilibmac; 
dialoq.h 

vehBowField 

NumberFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialoq.h 

Table  2.22-160  sim.c  Variable  Information. 
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2.22.2.9.1  SetUpSimulators 

SetUpSimulators  initializes  the  simulator  data  structures.  The  function  call  is 
SetUpSimulators().  Table  2.22-161  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

register  int 

Standard  C  type. 

Sim 

register  pointer  to 
SimDescriptor 

Oevelopment;SIMNET  ;MCC: 
libsimilibsim.h 

1  Calls  1 

Function 

Where  Described 

NewRr 

Standard  Memory  Manager  function  for  Macintosh. 

OpenResFile 

Standard  Resource  Manager  function  for  Macintosh. 

DeepShit 

See  Section  2.22.1.8.2. 

ExitToShell 

Standard  Segment  Loader  function  for  Macintosh. 

Table  2.22-161  SetUpSimulators  Information. 

2.22.2.9.2  SimulatorTypeCStr 

SimulatorTypeCStr  returns  a  C  string  naming  a  simulator  type.  The  function  call  is 
SimulatorTypeCStr(simulatorType).  Table  2.22-162  describes  the  parameters  used  by  this 
function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

simulatorType 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

simulatorTypes[simulatorType 

l.nameCstr 

pointer  to  char 

C  string  naming  simulator  type. 

Table  2.22-162  SimulatorTypeCStr  Information. 

2.22.2.9.3  SimulatorTypePStr 

SimulatorTypePStr  returns  a  Pascal  string  naming  a  simulator  type.  The  function  call  is 
SimulatorTypePStr(simulatorType).  Table  2.22-163  describes  the  parameters  used  by  this 
function. 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

SimulatorType 

int 

Standard  C  type. 
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Return  Values 

Return  Value 

Type 

simulatorTypes[simulatorType 

l.namePstr 

pointer  to  char 

MCC  CSCI 


Meanin 


Pascal  string  naming  simulator 


Table  2.22-163  SimulatorTypePStr  Information. 

2.22.2.9.4  CompanyName 

CompanyName  returns  a  string  naming  a  specified  company,  company.  This  routine  uses 
and  nxxiifies  a  static  buffer.  Tlie  string  returned  is  only  valid  until  the  next  call  to 
CompanyName.  The  function  call  is  CompanyName(company).  Table  2.22-164  describes 
the  parameters  used  by  this  function. 


Parameter 


Variable 


unitStrin 


Parameters 


Internal  Variables 


e 


inter  to  array  of  char 


inter  to  char 


Where  Typedef  Declared 


Standard  C  t 


Where  Tvoedef  Declared 


Standard  C  type. 


Return  Values 


Return  Value 


unitStrin 


cost  ring 


IS 


inter  to  char 


pointer  to  char 


Meaning  _ 


The  name  of  the  unit 


The  name  of  the  company 


Function 


SimDrawCompan 


Called  B 


Where  Described 


Se  Section  2.22.2.10.5. 


Table  2.22-164  CompanyName  Information. 

2.22.2.9.5  ShowVehicleDialog 

ShowVehicleDialog  displays  a  dialog  for  placing  or  reconstituting  a  vehicle.  The  function 
call  is  ShowVehicleDialog(sim,  leconstFlag,  completion).  Table  2.22-165  describes  the 
parameters  used  and  functions  called  using  this  function. 
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Internal  Variables 

Variable 

Where  Typedef  Declared 

simOata 

register  pointer  to 
SimulatorTypeData 

Deyelopment:SIMNET  :MCC: 
libsimilibsim  int.h 

str 


tempPlaceBuffer 


array  of  10  char 


SimPlaceData 


Staixlard  C  t 


DevelopmentiSIMNET  :MCC: 
libsim:libsim  int.h 


Return  Values 


Return  Value 


Meanin 


Unsuccessful. 


Successful. 


Function 


ShowCaution 


DownloadVehicleParameters 


ShowDialo 


SetStaticText 


LabelForceButtons 


Calls 


Where  Described 


See  Section  2.22.1.4.1. 


See  Section  2.22.2.3.3. 


See  Section  2.22.1.11.1. 


See  Section  2.22.1.11.8. 


See  Section  2.22.1.16.1. 


Table  2.22-165  ShowVehicleDialog  Information. 

2.22.2.9.6  CompleteVehicieDialog 

CompleteVehicleDialog  closes  a  dialog  for  placing  or  reconstituting  a  vehicle.  The  function 
call  is  Complete VehicleDiaiog(success).  Table  2.22- 166  describes  the  parameters  used  and 
functions  cdled  using  this  function. 


Parameter 


success 


Variable 


pastSim 


Parameters 


Internal  Variables 


e 


pointer  to  SavedDefaults 


Where  Tvpedef  Declared 


Standard  C  type. 


Where  Typedef  Declared 


Development;SIMNET  :MCC: 
libsim:libsim.h 


Function 


UploadVehicleParameters 


FindOldSi  mutators 


NextDefaultSlot 


ShowCaution 


ThrowDialo 


Calls 


Where  Described 


See  Section  2.22.2.3.2. 


See  Section  2.22.2.9.9. 


See  Section  2.22.2.9.10. 


See  Section  2.22.1.4.1. 


See  Section  2.22.1.11.3. 


Called  B 


Function 

Where  Described 

FREDPIaceEvent 

See  Section  2.22.2.5.2. 

MiPlaceEvent 

See  Section  2.22.2,7.5. 

M2PlaceEvent 

See  Section  2.22.2.8  6. 

Table  2.22-166  CompleteVehicleDialog  Information. 
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2.22.2.9.7  ValidBumperNumber 

ValidBumperNumber  checks  that  a  bumper  number  entered  in  a  vehicle  placement  dialog  is 
unique.  Tlie  function  call  is  ValidBumperNumber(dialog,  fp,  str).  Table  2.22-167 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  OiaiogState 

OevelopmentiSIMNET  :libmac; 
dialog,  h 

Ip 

pointer  to  TypeInFieldDefn 

DevelopmentiSIMNET  ;libmac: 
dialog. h 

str 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SimDescriptor 

Developmenl;SIMNET;MCC. 

Iibsim;libsim.h 

i 

register  short 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

0 

int 

Another  vehicle  already  has 
that  bumper  number. 

1 

int 

Unique  bumper  number. 

1  Calls  1 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

MtLoadSavedData 

See  Section  2.22.2.7.2. 

M2LoadSavedData 

See  Section  2.22.2.8.3. 

FREDLoadSavedData 

See  Section  2.22.2.5.2. 

Table  2.22-167  ValidBumperNumber  Information. 
2.22.2.9.8  LocationInExerciseArea 


LocationInExerciseArea  checks  that  a  location  is  within  the  bounds  of  the  terrain  database. 
The  function  call  is  Location! nExerciseArea(dialog,  ^,str).  Table  2.22-168  describes  the 
parameters  used  and  functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac; 
dialog,  h 

Ip 

pointer  to  TypeInFieldDefn 

DevelopmentiSIMNET  ilibmac; 
dialog. h 

str 

pointer  to  char 

Standard  C  type. 

I  I 
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1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

c 

register  pointer  to 
MapCoordinates 

DevelopmentrSIMNET  rlibmac; 
map.h 

msQ 

array  of  60  char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

Location  outside  bounds. 

1 

int 

Location  inside  bounds. 

I  Calls  I 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

Table  2.22-168  LocationlnExerciseArea  Information. 


2.22.2.9.9  FindOldSimulator 

FindOldSimulator  looks  up  a  simulator  by  company  and  bumper  number  in  the  table  of 
simulator  default  settings.  The  function  call  is  Find01dSimulator(company,  bumper, 
simulatorType).  Table  2.22-169  describes  the  parameters  used  by  this  function. 


Parameters 


Parameter 


comoan 


bumoer 


simulatorTvoe 


Variable 


Internal  Variables 


lERHX 


reoister  int 


register  pointer  to 
Saved  Defaults 


Where  Tvpedef  Declared 


Standard  C  type 


Standard  C  type. 


Standard  C  type. 


Where  Tvpedef  Declared 


Standard  C  type. 


Development:SIMNET  ;MCC: 
libsim:libsim.h 


Return  Value 


Return  Values 


Type 


pointer  to  SavedDefaults 


pointer  to  SavedDefaults 


Meaning 


Simulator  not  found. 


Simulator  lound. 


Function 


FREDLoadSavedData 


MtLoadSavedData 


M2LoadSavedData 


CompleteVehicleDialo 


Called  B 


Where  Described 


See  Section  2.22.2.5.2. 


See  Section  2.22.2.7.2. 


See  Section  2.22.2  8.3. 


See  Section  2.22.2.9.6. 


Table  2.22-169  FindOldSimulator  Information. 
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2.22.2.9.10  NextDefaultSlot 

NextDefaultSlot  returns  a  pointer  to  the  next  entry  for  storing  simulator  default  settings. 

The  function  call  is  NextDefaultSlotO.  Table  2.22-170  describes  the  internal  variables  used 
by  this  function. 


Variable 


Internal  Variables 


e 


reoister  int 


register  pointer  to 
SavedDefaults 


Where  Tynedef  Declared 


Standard  C  t 


Development:SIMNET  :MCC: 
libsimriibsim.h 


Return  Value 


0 


Sim 


Return  Values 


e 


pointer  to  SavedDefaults 


pointer  to  SavedDefaults 


Meaning 


No  entry  found. 


Next  entry. 


Function 


Called  B 


Where  Described 


See  Section  2.22.2.9.6. 


Table  2.22-170  NextDefaultSlot  Information. 

2.22.2.10  table.c 

Development:SIMNET  :MCC:libsim:table.c 

table.c  contains  routines  displaying  a  table  of  vehicle  simulators  available  for  placement. 

2.22.2.10.1  SimTableSetup 

SimTableSetup  populates  a  scrolling  table  of  simulators  with  all  those  in  a  particular 
company,  company.  The  function  call  is  SimTableSetup(defn,  company).  Table  2.22- 
171  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


defn 


comoan 


Parameters 


e 


pointer  to 

ScrollTableFieldDefn 


unsiqned  char 


Where  Typedef  Declared 


Development:SIMNET  :libmac: 
scroll. h 


Standard  C  type. 


internal  Variables 

Variable 

Where  Typedef  Declared 

Sim 

pointer  to  regiser 
SimDescriptor 

DevelopmentiSIMNET  ;MCC; 
libsim:libsim.h 

entry 

register  SimListEntryHandle 

DevelopmentiSIMNET  :MCC: 
libsimilibsim  int.h 

Standard  C  t 


1157 


BBN  Systems  and  Technologies _ MCC  CSCI 


1  Calls  1 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manaqer  function  for  Macintosh. 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

Table  2.22*171  SimTableSetup  Information. 


2.22.2.10.2  SimTableUpdate 


SimTableUpdate  inserts  or  updates  an  entry  in  a  table  of  simulators.  The  function  call  is 
SimTableUpdate(defn,  sim).  Table  2.22-172  describes  the  parameters  used  and  functions 
called  using  this  function. 


I  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  ilibmac; 
scroll. h 

Sim 

register  pointer  to 
SimDescriptor 

DevelopmentiSIMNET  :MCC: 
libsimilibsim.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

key 

Iona 

Standard  C  type. 

entry 

register 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ;libmac: 
scroll,  h 

I  Calls 

Function 

Where  Described 

LookupScrollTableEntry 

See  Section  2.22.1.24.1. 

UpdateScrollT  ableEntry 

See  Section  2.22.1.31.1. 

NewHandle 

Standard  Memory  Manaqer  function  for  Macintosh. 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

Table  2.22*172  SimTableUpdate  Information. 


2.22.2.10.3  SimTableEntry 


SimTableEntry  finds  the  record  for  the  simulator  represented  by  a  particular  simulator  table 
entry,  entry.  The  function  call  is  SimTableEntry(entry).  Table  2.22-173  describes  the 
parameters  used  by  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

entry 

Scroll!  able  EntryHandle 

DevelopmentiSIMNET  :libmac; 
scroll. h 

I  Return  Values  I 

I  Return  Value 

Type 

Meaning 

HHUIIill 

pointer  to  SimDescriptor 

DevelopmentiSlMNET  :MCC: 
libsim.libsim.h 

Table  2.22-173  SimTableEntry  Information. 
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2.22.2.10.4  SimDrawBumper 

SimE)rawBumper  fills  in  the  fields  of  the  bumper  column  in  the  simulator  table  to  display  to 
the  user.  The  function  call  is  SimDrawBumperfdefn,  col,  entry,  box).  Table  2.22-174 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Oevelopment.'SIMNET.'libmac; 

scroll.h 

col 

pointer  to 

ScrollTab.'eColumnDefn 

DevelopmentiSIMNET  ;libmac; 
scroll.h 

entry 

ScrollT  ableEntryHandle 

Development:SIMNET  :libmac; 
scroll.h 

box 

pointer  to  Rect 

DevelopmentTHINK  C; 

Mac  #includes;MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SimDescribtor 

Development:SiMNET  ;MCC: 
libsimilibsim.h 

strflOl 

char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

Move 

Standard  Quickdraw  function  for  Macintosh. 

StringWidlh 

Standard  Quickdraw  function  for  Macintosh. 

Drawstring 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.22-174  SimDrawBumper  Information. 


2.22.2.10.5  SimDrawCompany 


SimDrawCompany  fills  in  the  fields  of  the  company  column  in  the  simulator  table  to 
display  to  the  user.  The  function  call  is  SimDrawCompany(defn,  col,  entry,  box).  Table 
2.22-175  describes  the  parameters  used  and  functions  call^  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  ;libmac: 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

Development  iSIMNET  :libmac: 
scroll.h 

entry 

Scroll!  ableEntryHandle 

DevelopmentiSIMNET  :libmac; 
scroll.h 

box 

pointer  to  Rect 

DevelopmentTHINK  C; 

Mac  #includes:MacTvpes.h 
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1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SirnDescriotor 

DevelopmentiSIMNET  ;MCC: 
libsim;libsim.h 

CP 

register  pointer  to  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ComoanvName 

See  Section  2.22.2.9.4. 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.22-175  SimDrawCompany  Information. 

2.22.2.10.6  SimDrawLocation 

SimEhawLocadon  fills  in  the  fields  of  the  locadon  column  in  the  simulator  table  to  display 
to  the  user.  The  function  call  is  SimDrawLocationfdefn,  col,  entry,  box).  Table  2.22-176 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrotITableFieldDefn 

DevelopmentiSIMNET  tlibmac; 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

Development:SIMNET  rlibmac; 
scroll.h 

entry 

ScrollT  able  EntryHandle 

Development.SIMNET  ;libmac: 
scroll.h 

box 

pointer  to  Red 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SirnDescriotor 

Development  :SIMNET  :MCC: 
libsimriibsim.h 

Calls 

Function 

Where  Described 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.22-176  SimDrawLocation  Information. 

2.22.2.10.7  SimDrawPlaced 

SimDrawPlaced  fill  s  in  the  fields  of  the  placed  column  in  the  simulator  table  to  display  to 
the  user.  The  function  call  is  SimDrawPlacedfdefn,  col,  entry,  box).  Table  2.22-177 
describes  the  parameters  used  and  functions  called  using  this  function. 
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Parameters 

Parameter 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollTable  FieldDef  n 

DevelopmentiSIMNET  :libmac: 
scroll,  h 

col 

pointer  to 

Scroll!  ableColumnDef  n 

DevelopmentrSIMNET  :libmac; 
scroll.h 

entry 

Scroll!  able  EntryHandle 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

box 

pointer  to  Reel 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvpes.h 

Variable 


sim 


Internal  Variables 


e 


register  pointer  to 
SimDescriptor 


Where  Tvpedef  Declared 


Development:SIMNET  :MCC: 
libsim;libsim.h 


Calls 


Function  Where  Described 


Move  Standard  Quickdraw  function  for  Macintosh. 


StringWidth  Standard  Quickdraw  function  for  Macintosh. 


DrawStrinq  Standard  Quickdraw  function  for  Macintosh. 


Table  2.22-177  SimDrawPlaced  Information. 


2.22.2.10.8  SimDrawSide 

SimDrawSide  fills  in  the  fields  of  the  side  column  in  the  simulator  table  to  display  to  the 
user.  The  function  call  is  SimDrawSide(defn,  col,  entry,  box).  Table  2.22-178  describes 
the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

entry 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  Ci 

Mac  #includesimacTvpes.h 

Variable 


Sim 


Internal  Variables 


e 


register  pointer  to 
SirnDescriotor 


Where  Tvpedef  Declared 


Development:SIMNET  :MCC: 
libsim:libsim.h 


Function 


DrawStrin 


ForceNamePStr 


Calls 


Where  Described 


Standard  Quid^draw  function  for  Macintosh. 


See  Section  2.22.1.16.2. 


Table  2.22-178  SimDrawSide  Information. 
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2.22.2.10.9  SimDrawSimulator 

SimDrawSimulator  fills  in  the  fields  of  the  simulator  column  in  the  simulator  table  to 
display  to  the  user.  The  function  call  is  SimDrawSimulatorfdefn,  col,  entry,  box).  Table 
2.22-179  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


defn 


Variable 


Sim 


strflO 


Parameters 


e 


pointer  to 

Scroll!  ableFieldDetn 


pointer  to 

ScrollTableColumnDef  n 


Scroll!  ableEntryHandle 


pointer  to  Rect 


Internal  Variables 


e 


register  pointer  to 
SimDescriotor 


char 


Where  !vDedef  Declared 


DevelopmentiStMNE!  rlibmac: 
scroll.h 


DevelopmentiSIMNE!  rlibmac: 
scroll.h 


DevelormentrSIMNE!  rlibmac; 
scroll.h 


Development:!HINK  C: 
Mac  #includes;Mac!vDes.h 


Where  !vDedet  Declared 


Development  rSIMNE!  ;MCC: 
libsimriibsim.h 


Standard  C  type. 


Calls 


Function  Where  Described 


Num!oString  Standard  Binary  to  Decimal  Conversion  Package  function  for 

Macintosh. 


Move  Standard  Quickdraw  function  for  Macintosh. 


StringWidth  Standard  Quickdraw  function  for  Macintosh. 


Drawstring  Standard  Quickdraw  function  for  Macintosh. 


DrawChar  Standard  Quickdraw  function  for  Macintosh. 


Table  2.22-179  SimDrawSimulator  Information. 


2.22.2.10.10  SimDrawType 

SimDrawType  fills  in  the  fields  of  the  type  column  in  the  simulator  table  to  display  to  the 
user.  The  function  call  is  SimDrawTypefdefn,  col,  entry,  box).  Table  2.22-180  describes 
the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Where  !vpedef  Declared 

defn 

pointer  to 

Scroll!ableFieldDefn 

DevelopmentrSIMNE!  rlibmac: 
scroll.h 

col 

pointer  to 

Scroll!ableColumnDefn 

DevelopmentrSIMNE!rlibmacr 

scroll.h 

entry 

Scroll!  ableEntryHandle 

DevelopmentrSIMNE!  rlibmac: 
scroll.h 

box 

pointer  to  Rod 

Developmenl;!HINK  C; 

Mac  #includesMac!vpes.h 
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1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SimDescriptor 

Development  ;SIM  NET  ;MCC; 
libsimilibsim.h 

1  Calls  1 

Function 

Where  Described 

Drawstring 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.22-180  SimDrawType  Information. 

2.22.2.11  Sim  Pictures 

Sim  Pictures  contains  resources  that  determine  the  appearance  of  the  user  interface 
presented  for  placing  and  reconstituting  vehicle  simulators. 

2.22.2.12  resource.h 

Development:SIMNET:MCC:libsim:resource.h 

resource.h  defines  the  numbers  of  the  resources  present  in  the  Sim  Pictures  resource  file. 


2.22.3  libsupply 

Folder:  "Development:SlMNET:MCC:libsupply" 

This  folder  contains  a  library  of  C  definitions  representing  the  characteristics  of  various 
kinds  of  ammunition  known  to  the  MCC  system.  The  library  is  used  by  both  the  SCC  and 
AdminAxig  Macintosh  applications.  The  library  is  composed  from  the  following  files: 


2.22.3.1  libsupply. h 

Development;SIMNET:MCC:libsupply:libsupply.h 

libsupply.h  defines  the  external  interface  to  the  libsupply  library.  Table  2.22-181  describes 
the  variables  used  by  libsupply.h. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

ammoCharacteristics 

extern  array  of 
AmmoCharacteristics 

Development:SIMNET  :MCC: 
libsupply:libsupplv.h 

ammoT ableColumns 

extern  array  of 
ScrollTableColumnDefn 

Development.SIMNET.libmac; 
scroll. h 

Table  2.22-181  libsupply.h  Variable  Information. 
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2.22.3.2  data.c 

Developnwnt:SIMNET:MCC:libsupply:data.c 


data.c  defines  a  table  containing  the  name,  weight  and  volume  of  each  type  of  ammunition. 
Table  2.22-182  describes  the  variables  used  by  data.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

ammoCharacteristics 

array 

of[numberAmmoVarieties 

AmmoCharacteristics 

Development:SIMNET  :MCC: 
libsupply:libsupply.h 

Table  2.22-182  data.c  Variable  Information. 


2.22.3.3  version. h 

Development:SIMNET:MCC:libsupply:version.h 

version.h  defines  a  constant  determining  whether  the  libsupply  library  is  compiled  to 
represent  the  characteristics  of  US  or  Soviet  ammunition. 

2.22.3.4  transfer.c 

Development:SIMNET:MCC:libsupply:transfer.c 


transfer.c  implements  a  dialog  for  transferring  ammunition  between  one  truck  or  stockpile 
and  another.  Table  2.22-183  describes  the  variables  used  by  transfer.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

parties 

array  of  2  TransferParty 

Development;SIMNET  :MCC: 
libsupply:libsupply.h 

(completionCallback)  ( ) 

void  function  call 

Standard 

III  III  INI  lillllll  — 

int 

Standard  C  type. 

direction 

char 

Standard  C  type. 

transferAmmoArrowBtns 

array  of  2  RBFiekJDefn 

DevelopmentiSIMNET  :libmac; 
dialog. h 

transferAmmoOKBtn 

staticPushButtonFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

transferAmmoT  ranst  erBtn 

staticPushButtonFieldDefn 

Development;SIMNET  ilibmac: 
dialog.h 

transferAmmoQuantityField 

NumberFieldDefn 

Development:SIMNET  ;libmac: 
dialog.h 

transferAmmoT  ables 

array  of  2  ScrollTableFieldDefn 

Development.SIMNET'.libmac. 
scroll. h 

transferAmmoFieldList 

pointer  to  array  of  FiekJDefn 

Development:SIMNET  ilibmac: 
dialog.h 

transfer  AmmoDialog 

DialogDefn 

DevelopmentiSIMNET  ;libmac; 
dialog.h 

Table  2.22-183  transfer.c  Variable  Information. 
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2.22.3.4.1  ShowTransferAmmoDialog 


ShowTransferAmmoDialog  puts  up  a  dialog  for  transferring  ammunition.  The  function  call 
is  ShowTransferAmmoE)ialog(dialog,  resourcelD,  leftParty,  rightParty,  callback).  Table 
2.22-184  describes  the  parameters  us^  and  functions  call^  using  this  function. 


Parameters 


Parameter 


dialog 


resourcelD 


leftParty 


nghtParty 


callback 


pointer  to  TransferParty 


pointer  to  TransferParty 


void  function  call 


Where  Tvoedef  Declared 


DevelopmentTHINK  C; 
Mac  #includes;MacTvDes.h 


Standard  C  t 


DevelopmentiSIMNET  :MCC; 


Standard 


Return  Value 


(DialogState )  dialog 


Return  Values 


Type  _ 


pointer  to  DialogState 


Meanln 


Ammo  transfer  dialog. 


Function 


SellText 


Calls 


Where  Described 


See  Section  2.22.1.11.1. 


Standard  Dialoa  Manager  function  for  Macintosh. 


Table  2.22-184  ShowTransferAmmoDialog  Information. 
2.22.3.4.2  TransferAmmoFetch 

TransferAmmoFetch  loads  values  into  an  ammo  transfer  dialog,  dialog.  The  function  call 
is  Transfer AmmoFetch(dialog).  Table  2.22-185  describes  the  parameters  used  and 
functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

SetStaticText 

See  Section  2.22.1.11.8. 

Update!  ransf  erAmmoLoads 

See  Section  2.22.3.4.4. 

Table  2.22-185  TransferAmmoFetch  Information. 


2.22.3.4.3  TransferAmmoEvent 


TransferAmmoEvent  fields  an  event  in  a  transfer  ammo  dialog.  The  function  call  is 
TransferAmmoEvent(dialog,  itemNo).  Table  2.22-186  describes  the  parameters  used  and 
functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

SellText 

Standard  Dialoo  Manaaer  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

TotalAmmoCapacity 

See  Section  2.22.3.9.1. 

T  ransf  erBetween  AmmoLists 

See  Section  2.22.3.5.11. 

EnableControl 

See  Section  2.22.1.7.2. 

DisableControl 

See  Section  2.22.1.7.1. 

SetRadioButton 

See  Section  2.22.1.11.6. 

See  Section  2.22.3.4.5. 

DisposeScrollTable 

See  Section  2.22.1.30.2. 

ThrowDialoa 

See  Section  2.22.1.11.3. 

Table  2.22-186  Transfer AmmoE vent  Information. 


2.22.3.4.4  UpdateTransferAmmoLoads 

UpdateTransferAmmoLoads  updates  the  display  of  the  loads  on  board  the  two  parties.  The 
function  call  is  UpdateTransferAmmoLoads(dialog).  Table  2.22-187  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

1  Calls  1 

Function 

Where  Described 

EmptvScrollTable 

See  Section  2.22.1.28.2. 

FillAmmunitionList 

See  Section  2.22.3.5.1. 

SetScrollT  ableSelection 

See  Section  2.22.1.37.2. 

EnableControl 

See  Section  2.22.1.7.2. 

DisableControl 

See  Section  2.22.1.7.1. 

SetRadioButton 

See  Section  2.22.1.11.6. 

See  Section  2.22.3.4.5. 

1  Called  Bv  1 

Function 

Where  Described 

T  ransferAmmoFetch 

See  Section  2.22.3.4.2. 

Table  2.22-187  UpdateTransferAmmoLoads  Information. 
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2.22.3.4.5  UpdateCapacityDisplay 

UpdateCapacityDisplay  updates  the  display  of  the  weight  and  volume  of  ammunition  on 
board  the  two  parties.  The  function  call  is  UpdateCapacityDisplay(dialog).  Table  2.22- 
188  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac; 
dialoq.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

party 

register  pointer  to 

TransferPartv 

Development.SIMNET.MCC. 

libsuDplyilibsupply.h 

i 

reqister  short 

Standard  C  type. 

weiqht 

lonq 

Standard  C  type. 

volume 

lonq 

Standard  C  type. 

weiahtStrino 

array  of  50  char 

Standard  C  type. 

volumeStrinq 

array  of  50  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

T otal  AmmoCaoacitv 

See  Section  2.22.3.9.1. 

SetStaticText 

See  Section  2.22.1.11.8. 

1  Called  Bv  1 

Function 

Where  Described 

T  ransferAmmoEvent 

See  Section  2.22.3.4.3. 

Update!  ransferAmmoLoads 

See  Section  2.22.3.4.4. 

Table  2.22-188  UpdateCapacityDisplay  Information. 

2.22.3.5  ammolist.c 

Development:SIMNET;MCC:libsupply:ammolist.c 

ammolist.c  implements  the  scrolling  lists  of  ammunition  types  and  quantities.  Table  2.22- 
189  describes  the  variables  used  by  ammolist.c. 


1  Variables  1 

Variable 

Type 

Where  !ypedef  Declared 

ammo!  ableColumns 

array  of 

numberAmmoTableColumns 
Scroll!  ableColumnDefn 

Development:SIMNE!  :libmac: 
scroll. h 

Table  2.22-189  ammolist.c  Variable  Information. 
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FillAmmunitionList  populates  a  scrolling  list  of  ammunition  quantities  from  a  manifest, 
manifest.  The  function  call  is  FillAmmunitionList(defn,  manifest).  Table  2.22-190 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


defn 


manifest 


Parameters 


pointer  to 

ScrollTableFieldDefn 


Manifest 


Where  TvDedef  Declared 


Development:SlMNET  ihbmac; 
scroll,  h 


DevelopmentrSiMNET  ;MCC: 
includeiresuppiv.h 


Variable 


weioht 


volume 


entry 


Internal  Variables 


reaister  short 


AmrTKjListEntryHandle 


Where  Tvpedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Development;SlMNET  ;MCC: 


Function 


NewAmmoListEnt 


InstallAmrnoEnt 


Calls 


Where  Described 


See  Section  2.22.3.5.2. 


See  Section  2.22.3.5.3. 


Called  B 


Function 

Where  Described 

Update!  ransferAmmoLoads 

See  Section  2.22.3.4.4. 

Table  2.22*190  FillAmmunitionList  Information. 

2.22.3.5.2  NewAmmoListEntry 

NewAmmoListEntry  allocates  a  new  entry  for  a  scrolling  list  of  ammunition  quantities. 
The  function  call  is  NewAmmoListEntiy(type,  quantity,  weight,  volume).  Table  2.22-191 
describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

ammo 

AmmoUstEntryHandle 

New  ammo  ist  entry. 

Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manaaer  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

FillAmmunitionList 

See  Section  2.22.3.5.1. 

T  ransferAmmoBetweenLists 

See  Section  2.22.3.5.11. 

UpdateAmmoList 

See  Section  2.22.3.5.12. 

Table  2.22-191  NewAmmoListEntry  Information. 

2.22.3.5.3  InstallAmmoEntry 

InstallAmmoEntry  installs  a  new  entry  into  a  scrolling  list  of  ammuniton  quantities.  The 
function  call  is  InstallAmmoEntry(amnK),  defn).  Table  2.22-192  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

ammo 

AmnrwListEntryHandle 

Development:SIMNET  :MCC: 
libsupply:libsuoolv.h 

defn 

pointer  to 

ScrollTableFieldDefn 

Development.SIMNET.libmac: 

scroll.h 

1  Calls  1 

Function 

Where  Described 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

1  Called  By  1 

Function 

Where  Described 

FillAmmunitionList 

See  Section  2.22.3.5.1. 

T  ransferAmmoBetweenLists 

See  Section  2.22.3.5.11. 

UpdateAmmoList 

See  Section  2.22.3.5.12. 

Table  2.22-192  InstallAmmoEntry  Information. 
2.22.3.5.4  RemoveAmmoEntry 


RemoveAmmoEntry  removes  an  entry,  entry,  from  a  scrolling  list  of  ammunition 
quantities.  The  function  call  is  RemoveAmmoEntry(entry,  defn).  Table  2.22-193 
describes  the  parameters  used  and  functions  called  using  this  function. 
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Parameter 


entry 


Parameters 


e 


AmmoUstEntryHandle 


pointer  to 

Scroll!  ableFieldDef  n 


Where  Typedef  Declared 


OevelopmentiSIMNET  :MCC: 


OevelopmentiSIMNET  ilibmac: 
scroll,  h 


Variable 


Internal  Variables 


e 


ScrollTableEntryHandle 


Where  Typedef  Declared 


OevelopmentiSIMNET  ilibmaci 
scroll. h 


Function 


ScrollToShow 


SetScrollTableSelection 


RemoveScrollTableEnt 


Calls 


Where  Described 


See  Section  2.22.1.35.1. 


See  Section  2.22.1.37.2. 


See  Section  2.22.1.28.1. 


Called  B 


Function 

Where  Described 

T  ransf  erAmmoBetweenLists 

See  Section  2.22.3.5.11. 

Table  2.22-193  RemoveAmmoEntry  Information. 

2.22.3.5.5  SelectAmmoEntry 

SelectAmmoEntry  is  called  on  a  mouse  click  in  a  scrolling  list  of  ammunition  quantities. 
The  function  call  is  SelectAnimoEntry(defn,  row,  rect,  theEvent).  Table  2.22-194 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldOefn 

OevelopmentiSIMNET  ilibmaci 
scroll. h 

row 

int 

Standard  C  type. 

rect 

pointer  to  Rect 

OevelopmentiTHINK  Ci 

Mac  #includesiMacTvpes.h 

theEvent 

pointr  to  EventRecord 

OevelopmentiTHINK  Ci 

Mac  tincludesiEventMqr.h 

Variable 


entry 


Internal  Variables 


e 


ScrollTableEntryHandle 


Where  Typedef  Declared 


OevelopmentiSIMNET  ilibmaci 
scroll. h 


Function 


ScrollTableRowToEnt 


SetScrollT  ableSelection 


Calls 


Where  Described 


See  Section  2.22.1.34.1. 


See  Section  2.22.1.37.2. 


Table  2.22-194  SelectAmmoEntry  Information. 
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2.22.3.5.6  AmmoDrawName 


AmmoDrawName  draws  the  ammo  type  column.  The  function  call  is 
AmmoDrawName(defn,  col,  entry,  box).  Table  2.22-195  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevebpmentiSIMNET  ;libmac; 
scroll.h 

col 

pointer  to 

ScrollTableColumnDef  n 

Development:SIMNET  :libmac: 
scroll.h 

entry 

ScrollT  able  EntryHandle 

Development;SIMNET  ilibmac; 
scroll.h 

box 

pointer  to  Red 

Development:THINK  C: 

Mac  tfincludes.MacTypes.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

CP 

pointer  to  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.22*195  AmmoDrawName  Information. 


2.22.3.5.7  AmmoDrawNumber 


AmmoDrawNumber  draws  a  numeric  value  in  an  ammo  list.  The  function  call  is 
AmmoDrawNumber(col,  quantity,  n).  Table  2.22-196  describes  the  parameters  used  and 
functions  called  using  this  function. 
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1  calls  1 

Function 

Where  Described 

Move 

Standard  Quickdraw  function  for  Macintosh. 

Drawstring 

Standard  Quickdraw  function  for  Macintosh. 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

1  Called  By  I 

1  Function 

Where  Described 

See  Section  2.22.3.5.8. 

AmmoDrawWeight 

See  Section  2.22.3.5.9. 

AmmoDrawVolume 

See  Section  2.22.3.5.10. 

Table  2.22-196  AmmoDrawNuinber  Information. 

2.22.3.5.8  AmmoDrawQuantity 

AmmoDrawQuantity  is  the  ammo  quantity  column  draw  function.  The  function  call  is 
AmmoDrawQuantity (defn,  col,  en^,  box).  Table  2.22-197  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  rlibmac; 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

Development:SIMNET  ilibmac: 
scroll.h 

entry 

ScrollTableEntryHandle 

DevelopmenttSIMNET  :libmac. 
scroll.h 

box 

pointer  to  Red 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

1  Calls  1 

Function 

Where  Described 

AmmoDrawNumber 

See  Section  2.22.3.5.7. 

Table  2.22-197  AmmoDrawQuantity  Information. 


1173 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.22.3.5.9  AmmoDrawWeight 


AmmoDrawWeight  is  the  ammo  weight  column  draw  function.  The  function  call  is 
AmmoDrawWeight(defn,  col,  entry,  box).  Table  2.22-198  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  !vpedef  Declared 

defn 

pointer  to 

Scroll!  ableFieldDefn 

Development;SIMNE!:libmac; 
scroll. h 

col 

pointer  to 

ScrollT  ableCotumnDeIn 

Development:SIMNE!  ;libmac. 
scroll.h 

entry 

Scroll!  able  ErttryHandle 

Development:SIMNE!  ilibmac: 
scroll.h 

box 

pointer  to  Reel 

Development;!HINK  C; 

Mac  #includes;Mac!vDes.h 

1  Calls  1 

Function 

Where  Described 

AmnxjDrawNumber 

See  Section  2.22.3.5.7. 

Table  2.22-198  AmmoDrawWeight  Information. 
2.22.3.5.10  AmmoDrawVolume 


AmmoDrawVolume  is  the  ammo  volume  column  draw  function.  The  function  call  is 
AmmoDrawVolume(defn,  col,  entry,  box).  Table  2.22-199  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  !ypedef  Declared 

defn 

pointer  to 

Scroll!ableFieldDefn 

Development:SIMNE!  :libmac: 
scroll.h 

col 

pointer  to 

Scroll!  ableColumnDef  n 

Development:SIMNE!  :libmac: 
scroll.h 

entry 

Scroll!ableEntryHandle 

Development'.SIMNE!  rlibmac; 
scroll.h 

box 

pointer  to  Red 

Development:!HINK  C: 

Mac  #includes:Mac!vpes.h 

1  Calls  1 

Function 

Where  Described 

AmrrxjDrawNumber 

See  Section  2.22.3.5.7. 

Table  2.22-199  AmmoDrawVolume  Information. 
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2.22.3.5.11  TransferAmmoBetweenLists 

TransferAmmoBetweenLists  moves  a  quantity,  quantity,  of  ammunition,  type,  from  one 
list  to  another,  fromTable  andtoTable.  The  function  call  is 
TransferAmmoBetweenLists(fromTable,  toTable,  type,  quantity).  Table  2.22-200 
describes  the  parameters  used  and  functicMis  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Tvpedef  Declared 

fromTable 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  rlibmac: 
scroll,  h 

toTable 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac; 
scroll.h 

e 


uantit 


Standard  C  t 


Standard  C  t 


variable 


ammoChar 


weiaht 


volume 


Internal  Variables 


e 


pointer  to 

AmmoCharacteristics 


register 

AmmoUstEntrvHandle 


Where  Tvoedef  Declared 


Development:SIMNET  ;MCC: 


Standard  C  type. 


Standard  C  tvoe. 


Function 


LookuoScrollTableEnt 


UpdateScrollTableEnt 


RemoveAmmoEnt 


NewAmmoListEnt 


InstallAmmoEnt 


ScrollToShow 


SetScrollTableSelection 


Calls 


Where  Described 


See  Section  2.22.1.24.1. 


See  Section  2.22.1.31.1. 


See  Section  2.22.3.5.4. 


See  Section  2.22.3.5.2. 


See  Section  2.22.3.5.3. 


See  Section  2.22.1.35.1. 


See  Section  2.22.1.37.2. 


Called  B 


Function 

Where  Described 

T  ransf  erAmmoEvent 

See  Section  2.22.3.4.3. 

Table  2.22-200  TransferAmmoBetweenLists  Information. 
2.22.3.5.12  UpdateAmmoList 


UpdateAmmoList  updates  an  ammo  list  to  match  the  contents  of  a  manifest,  manifest..  The 
function  call  is  UpdateAmmoList(manifest,  table).  Table  2.22-201  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

manifest 

pointer  to  Manifest 

DevelopmentiSIMNET  iMCCi 
includeiresupply.h 

table 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmaci 
scroll.h 
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Variable 


n 


weioht 


volume 


Internal  Variables 


e 


reoister  short 


register 

AmmoListEntrvHandle 


int 


Where  TvDedef  Declared 


Standard  C  t 


Development:SIMNET  ;MCC: 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Function 


LookuoScrollTableEnt 


UpdateScrollT  ableEnt 


RemoveScrollTableEnt 


NewAmmoListEnt 


InstallAmmoEnt 


Calls 


Where  Described 


See  Section  2.22.1.24.1. 


See  Section  2.22.1.31.1. 


See  Section  2.22.1.28.1. 


See  Section  2.22.3.5.2. 


See  Section  2.22.3.5.3. 


Table  2.22-201  UpdateAmmoList  Information. 

2.22.3.6  libsupply_int.h 

Development:SIMI^T:MCC:libsupply;libsupply_int.h 
libsupply_int.h  supplies  defintions  internal  to  the  bbsupply  library. 

2.22.3.7  summary.c 

Development:SIMNET:MCC:libsupply:summary.c 

summary.c  contains  a  routine  which  displays  a  summary  of  the  load  onboard  a  truck. 

2.22.3.7.1  DisplayAmmoLoadSummary 


DisplayAmmoLoadSummary  displays  a  summary  of  the  load  aboard  an  ammo  truck.  The 
function  call  is  Display AmmoLoadSummary(manifest,  rect,  byAmmoType).  Table  2.22- 
202  describes  the  parameters  used  and  functions  called  using  tiiis  function. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

manifest 

register  pointer  to  Manifest 

Developmenl'.SIMNET  ;MCC. 
include:resupply.h 

rect 

pointer  to  Rect 

Development  THINK  C: 

Mac  #includes;MacTypes  h 

byAmmoType 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

string 

array  of  char 

Standard  C  type. 

weight 

long 

Standard  C  type. 

volume 

long 

Standard  C  type. 

V 

short 

Standard  C  type. 

half  Width 

short 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

APPEND 

Macro  defined  in 

Development  -.SIMNET  ;MCC  '.libsupply  '.summary  .c. 

Drawstring 

Standard  Quickdraw  function  for  Macintosh. 

TotalAmmoCapacity 

See  Section  2.22.3.9.1. 

MoveTo 

Standard  Quickdraw  function  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

PenPat 

Standard  Quickdraw  function  for  Macintosh. 

Line 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.22*202  DisplayAmmoLoadSummary  Information. 

2.22.3.8  suppIy_version.h 

Development:SIMNET:MCC:libsupply:supply_version.h 
supply_version.h  defines  the  version  of  the  libsupply  library  to  be  compiled. 

2.22.3.9  supply.c 

Development:SIMNET:MCC:libsupply:supply.c 
supply.c  contains  a  routine  related  to  the  supply  trucks. 

2.22.3.9.1  TotalAmmoCapacity 

TotalAmmoCapacity  sums  the  weight  and  volume  of  a  load  of  ammunition.  The  function 
call  is  TotalAmmoCapacity(manifest,  weight,  volume).  Table  2.22-203  describes  the 
parameters  used  by  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

manifest 

pointer  to  Manifest 

Development:SIMNET  ;MCC: 
include:resupply.h 

weight 

Standard  C  type. 

volume 

pointer  to  long 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

n 

register  int 

Standard  C  type. 

I  Called  By  I 

Function 

Where  Described 

T  ransf  e  rAmmo  Event 

See  Section  2.22.3.4.3. 

See  Section  2.22.3.4.5. 

I  DisplayAmmoLoadSummary 

See  Section  2.22.3.7.1. 

Table  2.22*203  TotalAmmoCapacity  Information. 
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2.22.4  Top-level  Includes 

Folder:  "Developmera:SIMNEJ .include " 

This  folder  contains  C  header  files  shared  across  various  SIMNET  Macintosh  libraries  and 
applications.  They  match  header  files  of  the  same  names  found  in  the  /simnetAnclude 
and/simnetAnclude/  protocol  directories  of  MCC  host  software.  These  header  files  are: 


2.22.4.1  basic.h 

Development:SIMNET:include:basic.h 

basic.h  defines  various  types  and  constants  used  in  the  representation  of  SIMNET  protocol 
data  units. 

2.22.4.2  battles.h 

Development:  SIMNET  :include:battles.h 

battles.h  defines  constants  used  to  identify  various  kinds  of  battle  schemes. 

2.22.4.3  repair.h 

Development:SIMNET  :include:repair.h 

repair.h  defines  constants  for  the  various  types  of  repairs  simulated  by  the  MCC  system. 

2.22.4.4  obj_type.h 

Development:SIMNET:include:obj_type.h 

obj_type.h  defines  constants  used  in  SIMNET  protocol  data  units  to  represent  various 
types  of  simulated  objects. 

2.22.4.5  veh_role.h 

DevelopmentrSIMNET  :include:veh_role.h 

veh_role.h  defines  constants  for  the  various  roles  that  can  be  served  by  a  vehicle  that  the 
MCC  system  controls  or  simulates. 

2.22.4.6  veh_type.h 

Development:SIMNET:include:veh_type.h 

veh_type.h  defines  constants  used  in  SIMNET  protocol  data  units  to  represent  various 
types  of  vehicles. 

2.22.4.7  address.h 

Development:SIMNET:include:address.h 

address.h  defines  constants  associated  with  addressing  the  simulator  sites. 

2.22.4.6  repair_ml.h 

Development:SIMNET.include:repair_m  1  .h 


repair_ml.h  defines  the  codes  for  various  repairs  simulated  by  the  SIMNET  Ml  simulator. 
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2.22.4.6  repair_m2.h 

Developtnent:SIMNET:include:repair_m2.h 

repair_m2.h  deBnes  the  codes  for  various  repairs  simulated  by  the  SIMNET  M2  simulator. 
File:  "Development:SIMNET:SIMNET  Resources" 

This  resource  file  contains  various  resources  required  by  routines  in  the  libmac  library, 
such  as  definitions  for  the  dialog  boxes  display^  by  the  caution  and  help  routines. 

Folder:  "Development:SIMNET:Icon  Button" 

This  folder  contains  source  code  implementing  an  "icon  button"  control,  which  behaves 
like  a  radio  button  or  check  box,  but  appears  as  an  icon  with  an  associated  text  label.  This 
code  is  compiled  to  produce  a  CDEF  code  resource,  which  is  then  copied  into  the 
"SIMNET  Resources"  resource  file. 

Folder:  "Development:SIMNET:MCC" 

This  folder  forms  the  root  of  the  hierarchy  of  folders  containing  SIMNET  MCC  software 
for  the  Macintosh. 


2.22.5  MCC  Includes 

Folder:  "Development:SIMNET:MCC  .include " 

This  folder  contains  C  header  files  shared  across  various  SIMNET  MCC  Macintosh 
applications.  They  match  header  files  of  the  same  names  found  in  the  /simnet/mcc/include 
directory  of  MCC  host  software.  These  header  files  are: 


2.22.5.1  ammo.h 

Development:SIMNET  :MCC:include:ammo.h 

ammo.h  defines  constants  for  the  various  kinds  of  ammunition  known  to  the  MCC  system. 

2.22.5.2  arty.h 

Development:SIMNET:MCC:include:arty.h 

arty.h  defines  constants  associated  with  the  MCC  system's  artillery  simulation. 

2.22.5.3  console.h 

Development:SIMNET:MCC:include:console.h 

console.h  contains  definitions  related  to  AppleTalk  communication  between  the  MCC  host 
and  its  Macintosh  consoles.  Table  2.22-204  describes  the  varaibles  used  by  console.h. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

hostSocket 

extern  int 

Standard  C  type. 

Table  2.22*204  console.h  Variable  Information. 
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2.22.5.4  MCCJimits.h 
Development:SIMNET  :MCXI!:include:MCC_limits.h 

MCCJimits.h  defines  various  limits  of  the  MCC  system  (e.g.,  the  capacity  of  a  fuel  or 
ammunition  supply  truck). 

2.22.5.5  options. h 

Development:SIMNET:MCC:include:options.h 

options.h  defines  a  structure  for  representing  the  presence  of  various  optional  elements  that 
the  MCC  system  may  simulate. 

2.22.5.6  manifest.h 

Development:  SIMNET:MCC:include  :manifest.h 

manifesLh  defines  a  structure  for  representing  quantities  of  various  kinds  of  ammunition 
and  fuel. 

2.22.5.7  sini_xact.h 

Development:  S IMNET :  MCC:  include  :sim_xact.h 

sim_xact.h  defines  AppleTalk  communication,  between  the  MCC  host  and  its  Macintosh 
consoles,  for  the  allocation,  placement  and  reconstitution  of  vehicle  simulators. 

2.22.5.8  fleet_type.h 

Development:SIMNET:MCC:include:fleet_type.h 

fleet_type.h  defines  the  contstants  distinguishing  the  various  truck  fleets  simulated  by  the 
MCC  system. 

2.22.5.9  resupply.h 

Development:SIMNET:MCC:include:resupply.h 

resupply.h  contains  definitions  associated  with  the  MCC  system’s  simulation  of  resupply 
trucks. 

2.22.5.10  veh_assign.h 

Development;SIMNET:MCC:include;veh_assign.h 

veh_assign.h  defines  constants  representing  the  organizational  units  io  which  a  vehicle  ma\ 
be  assigned. 
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INDEX  BY  SECTION  NUMBER 


AbortEvent 

AbortFetch 

access_147 

access_cmc 

ActivateConsole 

ActivateForExerciseStart 

ActivateForReconstitution 

ActivateForTowingAnival 

ActivateReplyReceived 

ActivateReplyTimedOut 

ActivateVehicle 

Activating  Combat  Vehicle  Simulators 

actloc.c 

Act_List_Add 

Act_List_Alloc 

Act_List_Delete 

Act_List_Hash 

Act_List_Init 

Act_List_Lx>c_Exists 

AdditionalSorties 

AddMenuFile 

address.c 

address.h 

AddSubscription 

adjust-c 

adjustchunks 

AdjustEvent 

AdjustFire 

AdjustScreenState 

Admin  Console  Definitions 

Admin  Console  Software 

Admin  Pictures 

Admin.h 

adminlog.c 

AdminMac.h 

aggregate.c 

alarm.c 

alarm.h 

AlarmsEnabled 

alloc.c 


2.17.3.1.8 

2.17.3.1.7 

2.20.2.20.3 

2.20.2.20.2 

2.21.1.7.2 

2.1.4.2.2 

2.1.4.2.3 

2.1. 4.2.4 

2.1.4.2.6 

2.1.4.2.7 

2.1.4.2.8 

2.1.4 

2.1.4.1 

2.1.4.1.4 

2.1.4.1.2 

2.1.4.1.5 

2.1.4.1.1 

2.1.4.1.3 

2.1.4.1.6 

2.18.2.3.2 

2.17.8.4.2 

2.20.1.9 
2.22.4.7 

2.20.1.1.9 

2.17.1.1 
2.22.1.19.10 

2.17.1.1.2 

2.6.3.1.2 

2.17.8.3.4 

2.15.4 

2.15.5 

2.15.6.1 

2.15.4.1 

2.13.1.1 

2.15.4.2 

2.20.1.3 

2.21.2.4 

2.21.2.3 

2.21.2.4.4 
2.13.2.1 


Index- 1 
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Allocation,  Placement  and  Reconstitution  of  Vehicle  Simulators 

2.13.2 

AUocEntryEvent 

2.13.2.1.6 

AllocEntryFetch 

2.13.2.1.5 

AUocShMem 

2.1. 1.5.1 

AUocTableEvent 

2.13.2.1.4 

AllocTableFetch 

2.13.2.1.2 

AUocTableSelect 

2.13.2.1.3 

Alloc_Free 

2.21.1.13.2 

Alloc_Minefield 

2.1.8.3.2 

AUotSorties 

2.7. 1.1.4 

ALOCEvent 

2.13.1.1.5 

ALOCInitFetch 

2.13.1.1.3 

ALOCReconstFetch 

2.13.1.1.4 

ammo.h 

2.22.5.1 

AmmoDrawName 

2.22.3.5.6 

AmmoDrawNumber 

2.22.3.5.7 

AmmoDrawQuantity 

2.22.3.5.8 

AmmoI>rawVoIume 

2.22.3.5.10 

AmmoDrawWeight 

2.22.3.5.9 

ammolist.c 

2.22.3.5 

AmmoTableSelect 

2.13.3.3.5 

AmmoTransferComplete 

2.13.3.3.6 

AmmoTruckLoadComplete 

2.15.1.1.2 

AmmoTruckTableEvent 

2.13.3.4.6 

AmmoTruckTableFetch 

2.13.3.4.5 

Appearance  of  Admin  User  Interface 

2.15.6 

Appearance  of  CAS  Console  User  Interface 

2.18.3 

Appearance  of  FSE  User  Interface 

2.17.6 

Appearance  of  Maint  User  Interface 

2.16.5 

Appearance  of  User  Interface 

2.14.3 

AppendByte 

2.11.1  1? 

Appends  tring 

2.22.1.44.2 

Appletalk  Network  Softwiire 

2.12 

ApplyToBatteries 

2.17.5.1.5 

ApproximateCos 

2.17.1.1.5 

ApproximateSin 

2.17.1.1.4 

arty.h 

2.22.5.2 

AssembleMissionString 

2.19.3.9.1 

AssembleResourceString 

2.19.3.9.2 

asset.c 

2.8.2, 2 

asset.h 

2.8.2. 1 

AssetKilled 

2.8  ^  2.5 

AssetReconstituted 

2. 8. 2. 2.4 

Index  2 


BBN  Systems  and  Technologies 


MCC  CSCI 


assoc. h 

2.20.1.26 

AssocAddToBucket 

2.20.1.25.1 

AssocAddToEndOfTimeList 

2.20.1.16.2 

AssocAddToStartOfTimeList 

2.20.1.16.1 

AssocAddTransaction 

2.20.1.23.2 

AssocAttach 

2.20.1.5.2 

AssocBucketLookup 

2.20.1.25.3 

AssocCacheResponse 

2.20.1.18.2 

AssocClose 

2.20.1.11.1 

AssocCreateFreeList 

2.20.1.24.1 

AssocCrcateMCA 

2.20.1.1.7 

AssocCreateMCAWithMask 

2.20.1.1.8 

AssocCurrendySubscribed 

2.20.1.1.3 

AssocCurrendySubscribedWithMask 

2.20.1.1.6 

AssocDef 

2.20.1.29 

AssocDeleteCachedResponse 

2.20.1.18.3 

AssocDeleteFromB  ucket 

2.20.1.25.2 

AssocDeleteFromTimeList 

2.20.1.16.3 

AssocDeleteTransaction 

2.20.1.23.3 

AssocError 

2.20.1.10.1 

AssocFindResponse 

2.20.1.18.5 

AssocFindTransaction 

2.20.1.23.4 

AssocFreeDescriptor 

2.20.1.24.4 

AssocGetDescriptor 

2.20.1.24.3 

AssocGetLastAddress 

2.20.1.15.1 

AssocGetRspMask 

2.20.1.13.2 

AssocGetSimAddress 

2.20.1.9.1 

AssocGrowFreeList 

2.20.1.24.2 

AssocInitResponse 

2.20.1.18.1 

AssocInitTransactions 

2.20.1.23.1 

AssocMoveToEndOfTimeList 

2.20.1.16.4 

AssocOpen 

2.20.1.5.1 

AssocPadBuffer 

2.20.1.2.2 

AssocProcessDatagramPDU 

2.20.1.21.1 

AssocProcessRequestPDU 

2.20.1.20.1 

AssocProcessResponsePDU 

2.20.1.19.1 

AssocReadParams 

2.20.1.22.2 

AssocReceiveAssocPDU 

2.20.1.14.1 

AssocReceivePDU 

2.20.1.6.1 

AssocRescheduleTransaction 

2.20.1.23.5 

AssocSendAggregate 

2.20.1.3.1 

AssocSendDatagram 

2.20.1.2.1 

AssocSendResponse 

2.20.1.4.2 

Index-3 


BBN  Systems  and  Technologies 


MCC  CSCI 


AssocSendTransact 

AssocSetProtocolFamily 

AssocSetRspMask 

AssocSetSendMask 

AssocSubscribe 

AssocSubscribeWithMask 

AssocTickAssocLayer 

AssocTimeOutOldResponses 

AssocUnsubscribe 

AssocUnsubscribeWithMask 

AssocWaitForPDU 

assocjcl.h 

atalk.c 

atalk.c 

atalk.c 

atalk.c 

atalk.c 

atalk.c 

ATAllocBuflfer 

ATAllocSocket 

atatp.c 

atbuf.c 

ATFreeBuffer 

ATFreeSocket 

atnbp.c 

ATPError 

ATPGetRequest 

ATPfhit 

ATPPut 

ATPFhitComplete 

ATPRequest 

ATPResponse 

ATPSendRequest 

ATPSendResponse 

ATPTimeout 

ATPTransact 

ATReceive 

ATRecv  Process 

ATSend  Process 

atskt.c 

Attach  Locks 

AttachMsgOueuc 

AttachSharedMem 


2.20.1.4.1 

2.20.1.12.1 
2.20.1.13.3 

2.20.1.13.1 

2.20.1.1.1 

2.20.1.1.4 
2.20.1.8.1 

2.20.1.18.4 
2.20.1.1.2 
2.20.1.1.5 

2.20.1.7.1 
2.20.1.27 

2.13.8.6 

2.14.2.1 

2.15.2.1 

2.16.1.1 

2.22.1.3 

2.22.2.3 
2.21.1.2.1 

2.21.1.4.1 

2.21.1.1 
2.21.1.2 
2.21.1.2.2 

2.21.1.4.2 

2.21.1.3 

2.22.1.3.6 
2.21.1.1.5 

2.21.1.7.4 
2.22  1.3.3 

2.21.1.7.5 
2.21  1  1.4 

2.21.1.1.6 
2.21. Ml 

2.21.1.1.2 

2.21.1.1.3 

2.21.1.7.3 

2.21.1  1.7 

2.10.2 
2.10.1 
2.21.1.4 
2.21.2.6,1 
2.21.2.8  1 
2.21  27.1 


Index-4 


BBN  Systems:  and  Technologies 


MCC  CSCI 


AttackCCV 

2.1.2.6.4 

Auxiliary  Software 

2.13.8 

azimuth.c 

2.21.1.5 

Background 

1.1 

basic,  h 

2.22.4.1 

Battalion 

2.1. 1.3.1 

battery.c 

2.17.2.1 

BatteryEventHandler 

2.17.2.1.4 

BatterySelectionViable 

2.17.5.1.9 

BatteryViable 

2.17.5.1.10 

batdes.h 

2.22.4.2 

BigProb 

2.22.1.8.2 

bigprob.c 

2.22.1.8 

BinNibble 

2.11.1.2 

Blend 

2.22.1.47.3 

block.c 

2.20.1.7 

Blow_Vehicle 

2.1.8.3.12 

BMOverviewEvent 

2.13.8.16.4 

BMOverviewFetch 

2.13.8.16.3 

BombRequest 

2.7. 1.1. 5 

BreachRequest 

2.1. 1.2.3 

Bridge 

2.1. 1.3. 2 

Bridge 

2.11.1.17 

Bridge  Program 

2.11.1 

BroadcastAppearance 

2.1.2.3.3 

BroadcastCCVBatch 

2. 1.2. 3. 2 

BroadcastDeactivate 

2.1.2. 3.4 

BroadcastToChildren 

2.2.1.4.5 

BtryReconstEvent 

2.13.4.2.11 

bucket.c 

2.20.1.25 

Build_ActivatePD .. 

2.1.4.2.5 

Build_Exercise_Status 

2.1.7. 1.6 

Build_Simulation_Status 

2.1.7. 1.7 

Build_Vehicle_Status 

2.1.7. 1.8 

cache.h 

2.21.7.1 

cache_alloc.c 

2.21.7.7 

cache_and_file_temiinate 

2.21.7.7.2 

cache_cntl.c 

2.21.7.8 

cache_data.c 

2.21.7.9 

cachejnit 

2.21.7.7.1 

cache_init.c 

2.21.7.10 

cache_query.c 

2.21.7.11 

cache_queue.c 

2.21.7.12 

Index-5 


BBN  Systems  and  Technologies 


MCC  CSCI 


cancel.c 

2.16.4.9 

CancelAlaim 

2.21.2.4.3 

CancelAtCommand 

2.17.1.3.5 

CancelMission 

2.18.2.6.4 

CancelOffers 

2.4.3.1.6 

CancelRepair 

2.16.4.9.5 

CancelResupply 

2.4.3.1.4 

CancelScrollTableSelection 

2.22.1.37.3 

CannedStuff.c 

2.19.3.1 

CAS  Console  Definitions 

2.18.1 

CAS  Console  Software 

2.18.2 

CAS  Pictures 

2.18.3.1 

cas.c 

2.1.2.1 

cas.c 

2.2.1. 1 

cas.c 

2.7. 1.1 

cas.c 

2.13.4.1 

CAS.h 

2.18.1.1 

CASMac.h 

2.18.1.2 

caution.c 

2.22.1.4 

ccv.c 

2.2.3.1 

ccv.c 

2.21.1.6 

ccv_change.c 

2. 1.2.6 

ccv_Tnodel.c 

2  1.2.3 

CEDTGToString 

2  19..1.10.8 

centerdialog 

2.22.1.19.5 

CEStringToDTG 

2.19.3.10.7 

CEW  Asset  Management 

2.8.2 

CEW  Console  Definitions 

2.19.1 

CEW  Console  Software 

2.19.2 

CEW  Objects 

2.19.5 

cew.c 

2.2.1  6 

cew.c 

2.13.4,4 

cew.c 

2.21.1.8 

cew.h 

2.13.4.3 

CEW.h 

2.19.1.3 

CEWAUocEvent 

2,13.4.4.3 

CEWAllocFetch 

2.13.4.4.2 

CE  WConfi  imE  ve  11 1 

2. 13.4.4.6 

CEWConfirmrctch 

2. 1,1. 4.4, 5 

CEWHost.h 

2, 8. 1.2 

CEWMac.h 

2.19.1.2 

CEWRcconsJivcin 

2.13  4.4  s 

CEWReconstFetofi 

2.13.4.4  7 

Index -6 


BBN  Systems  and  Technologies 


MCC  CSCI 


CheckBattery 

2.17.5.1.8 

• 

CheckBreachDialog 

2.19.3.2.7 

CheckConfig 

2.17.8.1.6 

CheckDialogs.c 

2.19.3.2 

CheckDTGString 

2.19.3.3.2 

CheckEmplacementDialog 

2.19.3.2.5 

CheckFiring 

2.17.1.3.6 

CheckForCondition 

2.18.2.1.2 

CheckLastField 

2.22.1.11.5 

CheckList.c 

2.19.5.1 

CheckListh 

2.19.5.2 

CheckList: :  AddRow 

2.19.5.1.2 

CheckList:  :GetRow 

2.19.5.1.4 

CheckList;  tGelState 

2.19.5.1.6 

CheckList:  :init 

2.19.5.1.1 

CheckList: :  SetRow 

2.19.5.1.3 

CheckList:  :SetState 

2.19.5.1.5 

CheckList:  :ToggleState 

2.19.5.1.7 

CheckList_Handler 

2.19.3.7.2 

CheckMandatoryEvent 

2.13.8.8.1 

CheckMandatoryFields 

2.22.1.13.1 

CheckMissionTypeDialog 

2.19.3.2.9 

# 

CheckMoveDialog 

2.19.3.2.8 

CheckReviewDialog 

2.19.3.2.13 

CheckSchedMission 

2.17.8.1.19 

Checks  imulatorActivity 

2.1.4.2.12 

CheckSortieLimits 

2.18.2.3.4 

CheckStatBreachDialog 

2.19.3.2.11 

Checks  tatEmplacementDialog 

2.19.3.2.10 

CheckStatMoveDialog 

2.19.3.2.12 

CheckTimers 

2.15.5.7.2 

CheckTimers 

2.16.4.11.2 

CheckTimers 

2.17.5.1.1 

CheckUTMString 

2.19.3.3.1 

CheckVolleyTable 

2.1.2.4.3 

CheckvsCurrentTime 

2.19.3.3.3 

CheckvsCurrentTimeStr 

2.19.3.3.4 

Check_Net 

2.1. 1.2.7 

check_x_ints 

2.19.4.3.2 

check_x_ints 

2.21.1.24.2 

check_y_ints 

2.19.4.3.3 

check_y_ints 

2.21.1.24.3 

• 

ChkSerIn 

2.11.1.14 

Index-7 


BBN  Systems  and  Technologies 


MCC  CSCI 


ChkSerOut 

2.11.1.15 

CleanupDeadScx;kets 

2.21.2.12.6 

CleanupSockets 

2.21.2.12.4 

ClearDialogsForMission 

2.18.2.2.3 

ClearField 

2.19.3.9.5 

ClearHot 

2.18.2.6.5 

Clock  Reset  Command 

2.9.2 

clock.c 

2.9.2. 1 

clock.c 

2.22.1.6 

clock.h 

2.22.1.5 

ClockCommand 

2.9.2.1.1 

close.c 

2.20.1.11 

CloseCancelDialog 

2.16.4.9.4 

CloseDispatchDialog 

2.15.3.1.6 

CloseDispatchDialog 

2.16.4.6.5 

CloseHaltDialog 

2.15.5.5.6 

CloseHaltDialog 

2.16.4.10.5 

CloseLoadDialog 

2.15.1.1.6 

CloseNetworkInterface 

2.21.1.22.4 

CloseRecoverDialog 

2.16.2.1.5 

CloseSocket 

2.21.2.10.4 

Closes  tartDialog 

2.16.4.7.11 

cmd.c 

2.9.1.2 

cmd_clock 

2.9.1.2.2 

cmd_disable 

2.9.1. 2  3 

cmd_exit 

2.9.1.2.4 

cmd_list 

2.9.1. 2. 5 

cmd_perf 

2.9.1. 2. 6 

cmd_restart 

2.9.1. 2. 7 

cmd_restore 

2.9.1.2.8 

cmd_save 

2.9. 1.2. 9 

cmd_send_breach 

2.9. 1.2.1 

cmd_status_all 

2.9.1.2.10 

cmd_statu  s_bumper 

2.9.1.2.1 1 

cmd_status_ipc 

2.9.1.2.12 

cmd_status_net 

2.9.1.2.13 

cmd_status_proccss 

2.9.1.2.14 

cmd._status_sim 

2.9.1.2.15 

cmd_status_sims 

2.9.1.2.16 

cmd. statu  s_vid 

2.9.1.2.17 

cmd_status  yumm 

2.9.1.2.18 

cmd_trace 

2.9.1.2,19 

Command  Line  Interface 

2.9.1 

Indcx-S 


BBN  Systems  and  Technologies 


MCC  CSCI 


CommenceFFE 

2.17.1.3.4 

Communication  with  World 

2.2.4 

CompanyName 

2.22.2.9.4 

CompleteDisplacement 

2.13.8.10.1 

CompleteVehicleDialog 

2.22.2.9.6 

ComputeAdjustment 

2.17.1.1.3 

ComputeETA 

2.13.8.10.18 

ComputeETA 

2.15.3.1.4 

ComputeETA 

2.16.2.1.4 

ComputeETA 

2.16.4.6.4 

comp_pct 

2.13.8.10.19 

ComWindow::AddHotSpot 

2.19.5.3.2 

ComWindow:  :CheckHotSpot 

2.19.5.3.4 

ComWindow::initial 

2.19.5.3.3 

ComWindow::show 

2.19.5.3.1 

ComWindows.c 

2.19.5.3 

ComWindows.h 

2.19.5.4 

condition.c 

2.18.2.1 

ConditionEvent 

2.18.2.1.5 

ConditionFetch 

2.18.2.1.4 

Configuration  and  Configuration  Management 

1.4 

ConsiderVehicle 

2.1.2.1.3 

consistent.c 

2.21.7.13 

Console 

2.1. 1.3. 3 

console.c 

2.21.1.7 

console.h 

2.19.1.6 

console.h 

2.22.5.3 

ConsoleRelease  Arrived 

2.21.1.7.7 

control.c 

2.22.1.7 

CoRoleFetch 

2.13.8.11.13 

CountCaution 

2.22.1.4.4 

CountRoundsFired 

2.1.6.2.10 

count_objects_in_patch 

2.21.7.26.1 

count_treelines_in_patch 

2.21.7.29.1 

count_trees_in_patch 

2.21.7.30.1 

createhpict 

2.22.1.19.23 

createte 

2.22.1.19.22 

Crossing_Minefield 

2.1.8.3.14 

CSC  Descriptions 

2 

css.c 

2.2.1.2 

css.c 

2.13.3.1 

CS  SConfirmEvent 

2.13.3.1.8 

CSSConfirmFetch 

2.13.3.1.7 

Index-9 


BBN  Systems  and  Technologies 


MCC  CSCI 


CSSTypeBranch 

2.13.3.1.3 

CSSTypeFetch 

2.13.3.1.2 

CurBattleScheme 

2.1.1.3.14 

Current_Minefield_Count 

2.1.8.3.1 

data.c 

2.1.1. 1 

data.c 

2.6.1.2 

data.c 

2.13.8.7 

data.c 

2.14.1.4 

data.c 

2.15.5.6 

data.c 

2.16.4.12 

data.c 

2.17.7.4 

data.c 

2.18.1.4 

data.c 

2.21.1.9 

data.c 

2.21.7.14 

data.c 

2.22.2.4 

data.c 

2.22.3.2 

DeactivateAUVehicles 

2.1.5. 1.2 

DeactivateReplyReceived 

2.1.4.2.9 

DeactivateReplyTimedOut 

2.1.4.2.10 

DeactivateVehicle 

2.1.4.2.11 

decode  .c 

2.21.1.10 

DecodeFrame 

2.11.1.8 

DecodeHuUToWorldMatrix 

2.21.1.10.1 

DecodeRotationVector 

2.21.1.10.2 

DecodeVehicleStatusFAAD 

2.21.1.12.2 

DecodeVehicleStatusFRED 

2.21.1.14.2 

DecodeVehicleStatusM  1 

2.21.1.20.2 

DecodeVehicleStatusM2 

2.21.1.21.2 

defaults.h 

2.20.1.28 

DefaultTrainsEvent 

2.13.3.1.4 

DefineBattleScheme 

2.1.1.3.15 

DeleteResourceLists 

2.19.3.7.3 

Deletes  ubscription 

2.20.1.1.10 

Delivery  of  Fire 

2.6.3 

demo.c 

2.15.5.3 

demo.c 

2.16.4.4 

DepotConfirmEvent 

2.13.3.2.2 

DepotOjnfirmFetch 

2.13.3.2.1 

depots.c 

2.13.3.2 

deqiieue_terrain_patch 

2.21.7.12.1 

DetermineMines 

2.19.3.2.14 

dialine.c 

2.22  1.10 

Dialog  Li.st.s  of  Assets 

2.19.3 

Index- 10 


BBN  Systems  and  Technologies 


MCC  CSCI 


Dialog  Lists  of  Scheduled  Missions 

dialog.c 

dialog.c 

dialog.c 

dialog.c 

dialog.h 

DialogEvent 

DialogFieldSupport.c 

DialogLookupField 

DialogOutlineltem 

DialogSeqEvent 

DialogSeqNext 

DialogSeqPrev 

DialogWindow  "activate 

DialogWindow :  iBringToFront 

DialogWindow:  :close 

DialogWindow:  :equal 

DialogWindow:  :GetDialogPtr 

DialogWindow:  :GetItemRect 

DialogWindow:  :GetText 

DialogWindow:  :GetValue 

DialogWindow::handler 

DialogWindow::HiliteItem 

DialogWindow :  :init 

DialogWindow::quit 

DialogWindow : :  SelectText 

DialogWindow: :  SetText 

DialogWindow::SetUserltem 

DialogWindow: :  SetValue 

Dialog_Windows.c 

Dialog_Windows.h 

dialookup.c 

diamand.c 

DisableControl 

DisableTeam 

DisableTruck 

DiscardPopUpDialog 

DiscardPopUpDialog 

dispatch.c 

dispatch.c 

DispatchAlarm 

displace.c 

displace.c 


2.17.4 

2.13.8.8 

2.14.2.2 

2.18.2.2 
2.22.1.11 

2.22.1.9 

2.22.1.11.4 

2.19.3.3 
2.22.1.12.1 
2.19.5.5.18 

2.22.1.39.3 

2.22.1.39.4 

2.22.1.39.5 

2.19.5.5.3 
2.19.5.5.17 

2.19.5.5.6 

2.19.5.5.15 

2.19.5.5.16 
2.19.5.5.14 

2.19.5.5.7 

2.19.5.5.10 
2.19.5.5.2 

2.19.5.5.12 

2.19.5.5.1 

2.19.5.5.4 

2.19.5.5.9 

2.19.5.5.8 

2.19.5.5.13 

2.19.5.5.11 

2.19.5.5 

2.19.5.6 
2.22.1.12 

2.22.1.13 

2.22.1.7.1 
2.16.4.11.5 

2.15.5.7.4 

2.15.5.7.9 

2.16.4.11.9 

2.15.3.1 

2.16.4.6 

2.21.2.4.5 

2.4.2. 1 

2.5.2. 1 


Index- 1 1 


BBN  Systems  and  Technologies 

MCC  CSCI 

displace.c 

2.13.8.10 

displaces 

2.17.3.1 

A 

displace.h 

2.13.8.9 

w 

DisplaceBranch 

2.13.8.10.4 

DisplaceDispatchEvent 

2.13.8.10.15 

DisplaceDispatchFetch 

2.13.8.10.14 

DisplaceEvent 

2.13.8.10.3 

DisplaceEvent 

2.17.3.1.5 

DisplaceFetch 

2.13.8.10.2 

DisplaceFetch 

2.17.3.1.3 

DisplaceHaltEvent 

2.13.8.10.17 

DisplaceHaltFetch 

2.13.8.10.16 

Displacement  of  Artilleiy  Batteries 

2.17.3 

DisplaceSelectElement 

2.13.8.10.5 

DisplaceSelectUnit 

2.13.8.10.6 

Display  AmmoLoadS  ummary 

2.22.3.7.1 

DisplayCeV 

2.21.1.6.1 

DisplayMsgQStatus 

2.9.3. 1.4 

DisplaySemStatus 

2.9.3. 1.3 

Displays  hmStatus 

2.9.3. 1.2 

DisposeScrollTable 

2.22.1.30.2 

disposetopic 

2.22.1.19.17 

_ 

DistBetween2Pts 

2.22.1.23.2 

• 

DistributeBursts 

2.6.3.1.8 

ditl.h 

2.18.1.6 

DoAbout 

2.19.3.4.2 

DoAbout.c 

2.19.3.4 

DoMenu 

2.19.2.2.2 

DoneStatus 

2.19.3.8.5 

DoResourceSiatus 

2.19.3.8.1 

Downloads  tryParameters 

2.13.4.2.9 

DownloadGunData 

2.17.8.3.2 

DownloadInitialData 

2.15.5.1,2 

DownloadInitialData 

2.16.4.1  2 

DownloadOptions 

2.13.8.6.4 

DownloadParameters 

2.14.2.1.2 

Downloads  imulators 

2.22.2.3.1 

DownloadTerrain 

2.13.8.6/1 

DownloudTeirainMap 

2.22.1.3.1 

DownloadTruckParameters 

2.13.3.6.? 

DownloadVehicleParametcrs 

2.22.2  3.3 

Do_Generic_SuitusQuery 

2.1.7. 1.9 

do_mode  .cmd 

2.20.2  ' 

• 

Index- 12 


BBN  Systems  and  Technologies 

- ! 

MCC  CSCI 

do_mode_cnxl_l  47 

2.20.2.7.7 

A 

do_mode_cmd_cmc 

2.20.2.7.6 

w 

draw.h 

2.22.1.2 

DrawBatteiyRect 

2.17.2.1.6 

DrawBatteryText 

2.17.2.1.5 

DrawClock 

2.22.1.6.1 

DrawDispElement 

2.13.8.10.9 

DrawDispETA 

2.13.8.10.12 

E>rawDispStatus 

2.13.8.10.11 

DrawDispUnit 

2.13.8.10.10 

DrawFixTable 

2.22.1.42.4 

DrawItemOutline 

2.22.1.27.1 

DrawLine 

2.22.1.10.1 

drawlist 

2.22.1.19.7 

DrawReconstElement 

2.13.5.2.3 

DrawReconstVehicle 

2.13.5.2.4 

DrawScrollTable 

2.22.1.31.2 

DrawScrollTableC 

2.22.1.31.3 

DrawStatusWindow 

2.17.2.2.3 

drawtopic 

2.22.1.19.15 

DropBombs 

2.7.1. 1.6 

dtg.c 

2.22.1.15 

• 

dtg.h 

2.22.1.14 

DTGElapsed 

2.22.1.15.3 

DTGToString 

2.22.1.15.1 

dump.c 

2.21.7.15 

dump_terrain 

2.21.7.15.4 

elevation.c 

2.21.7.16 

EmplaceRequest 

2.1. 1.2.2 

Emplace_Generic 

2.1.8.3.6 

EmptyScrollTable 

2.22.1.28.2 

EnableControl 

2.22.1.7.2 

EnableMenus 

2.17.8.4.4 

EnableTeam 

2.16.4.11.6 

EnableTruck 

2.15.5.7.5 

EncodeFrame 

2.11.1.6 

EncodeVehicleStatusFAAD 

2.21.1.12.1 

Encode  VehicleStatusFRED 

2.21.1.14.1 

EncodeVehicleStatusM  1 

2.21.1.20.1 

EncodeVehicleStatusM2 

2.21.1.21.1 

EndFireMission 

2.17.1.2.10 

EndMission 

2.17.8.5.2 

• 

EndMissionBattery 

2.17.5.1.7 
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EndOfFrame 

2.11.1.13 

enqueue_terrain_patch 

2.21.7.12.2 

error.c 

2.20.1.10 

error.c 

2.21.1.11 

error.c 

2.21.2.5 

error.c 

2.21.7.17 

EstablishBatterySelection 

2.17.5.2.1 

Exercise 

2.1. 1.3.4 

exercise.c 

2.13.8.11 

ExerciseStopped 

2.2.4.2.3 

External  Interfaces 

1.2 

Ex_Log 

2.1. 1.3.3 

faad.c 

2.21.1.12 

family.c 

2.20.1.12 

ffe.c 

2.17.1.3 

FFEEvent 

2.17.1.3.3 

file.c 

2.13.8.12 

file.c 

2.17.8.1 

FillAmmunitionList 

2.22.3.5.1 

fUl_bytes 

2.21.1.30.1 

FindAnOpenSpot 

2.1.2.5.1 

FindOldSimulator 

2.22.2.9.9 

find_hei  ght_on_poly 

2.21.7.16.5 

find_support 

2.21.7.16.3 

fire.c 

2.1.2.4 

fire.c 

2.6.3.1 

fire.c 

2.17.1.2 

FireEntryEvent 

2.17.4.1.12 

FireEvent 

2.17.1.2.5 

FireForEffect 

2.6.3. 1.3 

FireRequest 

2.6.3. 1.1 

FireShell 

2. 1.2. 3. 5 

FireTableDrawDescription 

2.17.4.1.8 

FireT  ableDrawLocation 

2.17.4.1.7 

FireTableEhnwRemarks 

2.17.4.1.9 

FireTableSelect 

2.17.4.1.5 

firetarget.c 

2.17.4.1 

FireVolley 

2.1.2.4.2 

FireVolley 

2.17.5.1.2 

FirstScrollTableSelection 

2.22.1.37.5 

fixedpt_to_mil 

2.21.1.5.2 

FixTableEvent 

2.22.1.42.3 

FixTableRowRect 

2.22  1 .42  5 
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fleet_type.h 

2.22.5.8 

force.c 

2.22.1.16 

ForceNamePStr 

2.22.1.16.2 

fpf.c 

2.17.1.4 

FPFEntryEvent 

2.17.4.2.11 

FPFEvent 

2.17.1.4.6 

FPFRequest 

2.6.3.1.4 

FPFlableDrawDescription 

2.17.4.2.8 

FPFTableDrawLeft 

2.17.4.2.6 

FPFT  ableDrawNumber 

2.17.4.2.5 

FPFTableI>rawRight 

2.17.4.2.7 

FPFTableSelect 

2.17.4.2.4 

fpftarget.c 

2.17.4.2 

fqueue.c 

2.21.1.13 

FQueue_Analyze 

2.21.1.13.9 

FQueue_Create 

2.21.1.13.3 

FQueue_Dump_Bucket 

2.21.1.13.8 

FQueue_Insert 

2.21.1.13.4 

FQueue_Remove 

2.21.1.13.5 

FQueue_Retrieve 

2.21.1.13.7 

FQueue_Scan 

2.21.1.13.6 

fred.c 

2.21.1.14 

fred.c 

2.22.2.5 

FREDLoadSavedData 

2.22.2.5.2 

FREDPlaceEvent 

2.22.2.5.3 

FREDSetDefaults 

2.22.2.5.1 

fTed_encode_failures 

2.21.1.14.3 

free_list.c 

2.20.1.24 

Free_Minefield 

2.1.8.3.3 

FSE  Console  Definitions 

2.17.7 

FSE  Console  Software 

2.17.8 

FSE  Pictures 

2.17.6.1 

fse.c 

2.2.1.3 

fse.c 

2.13.4.2 

FSE.h 

2.17.7.1 

FSEConfirmEvent 

2.13.4.2.7 

FSEConfirmFetch 

2.13.4.2.6 

FSEMac.h 

2.17.7.2 

FuelTruckLoadEvent 

2.15.1.1.4 

FuelTruckLoadFetch 

2.15.1.1.3 

FuelTruckTableFetch 

2.13.3.4.7 

FutureEvent 

2.18.2.2.7 

FutureMissionTest 

2.17.8.4.3 
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generic.c 

geometry.c 

GetCEWParameters 

GetCompanyFromOrg 

GetConfig 

getcontenthdl 

GetCurrcntMonth 

GetDisTime 

GetFireDialogInfo 

GetFPFDialogInfo 

GetGuises 

GetGunAjdmuth 

gethelp 

GetlntemProcID 

GetOldStyleCompany 

GetSCCVehicleIndex 

GetSocketName 

GetTerrainBounds 

GetTruckParameters 

GetVehicIeLocation 

get_closest_object_in_patch 

get_closest_treeline_in_patch 

get_closest_trec_in_patch 

get_device_nuniber 

Get_DTG 

get_grid_number 

get_Iocks 

get_nth_object_in_patch 

get_nth_treeline_in_patch 

get_nth_tree_in_patch 

get_object_name_list 

get_obstr_object_in_patch 

get_patch.c 

get_texture_name_list 

get_type 

GrabReqEntry 

grid.c 

gr  .loc_num.c 

GuideBomber 

guise.c 

halt.c 

halt.c 

hash.c 


2.21.1.15 

2.1.8.1 

2.21.1.8.1 

2.21.1.25.5 

2.17.8.1.4 
2.22.1.19.20 

2.19.3.10.6 

2.19.3.3.6 

2.17.1.2.2 

2.17.1.4.2 

2.21.1.17.1 
2.13.4.2.12 
2.22.1.19.19 

2.21.2.12.7 

2.21.1.25.6 

2.2.1. 6.4 
2.21.2.10.11 

2.19.2.1.6 

2.21.1.29.1 

2.1. 1.5.4 

2.21.7.26.5 

2.21.7.29.5 

2.21.7.30.5 

2.20.2.10.7 

2.22.1.15.4 

2.21.7.16.6 

2.20.2.21.1 

2.21.7.26.3 

2.21.7.29.3 

2.21.7  30.3 
2.21.7.15.23 

2.21.7.26.7 

2.21.7  18 
2.21.7.15.22 
2  20.2  (0.6 
2.21.2.12.2 
2  21.1.16 
2.2)7  1  ^ 

2. 1  2.1.2 
2  21.1  17 
5 

2.16.4.10 

2.21.1.1^ 
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Hash_Get_Entry 

header.c 

HeadingSetUp 

HeldEvent 

HeldFetch 

help.c 

help.h 

helpidindex 

helpinit 

helplocal.h 

helpmove 

helpshutdown 

HelpStatus 

HexDigit 

HideCCV 

HiliteMission 

HiliteRect 

HiliteScroUT  ableSelection 

HotSpots.c 

hpickevents 

htopicevents 

h_to_w.c 

IgnoreStatusQuery 

include.c 

included_unit 

including_unit 

IndirectFireDamage 

indone 

inflate_rect 

init.c 

init.c 

init.c 

InitAlarms 

InitArtyBranch 

InitArtyEvent 

InitArtyFetch 

InitCASEvent 

InitCCV 

InitErrorHandling 

Initialization 

Initialization  and  Communication 
Initialization  and  Communication 
Initialization  and  Communication 


2.21.1.13.1 

2.21.7.21 

2.19.3.8.4 
2.18.2.2.11 
2.18.2.2.10 

2.22.1.19 
2.22.1.17 

2.22.1.19.18 

2.22.1.19.1 

2.22.1.18 

2.22.1.19.13 

2.22.1.19.2 

2.19.3.8.6 
2.11.1.1 

2.21.1.6.2 

2.18.2.6.3 

2.19.3.10.4 

2.22.1.31.4 

2.19.3.5 

2.22.1.19.6 

2.22.1.19.14 

2.21.7.20 

2.1.7. 1.5 

2.21.7.22 

2.1.7. 1.3 

2.1.7. 1.4 

2.1.2.4.6 

2.19.3.5.1 

2. 1.8. 1.4 
2.13.8.13 

2.21.1.19 

2.22.1.20 

2.21.2.4.1 

2.13.4.2.4 
2.13.4.2.3 

2.13.4.2.2 

2.13.4.1.3 

2.1.2.3.1 

2.21.1.11.1 
2.2.1 

2.4.1 

2.5.1 

2.6.1 
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Initialization  and  Communication 

2.7.1 

Initialization  and  Communication 

2.8.1 

Initialization  Software 

2.3.1 

w 

InitializeAllTrucks 

2.4.1. 1.7 

InitializeAllTrucks 

2.5.1. 1.7 

InidalizeAsset 

2.8.2.2.3 

InidalizeAssets 

2.8.2.2.2 

InidalizeBattery 

2.6.1. 1.4 

InidalizeProcess 

2.21.1.19.1 

InitializeResupply 

2.4.3.1.1 

InidalizeTruck 

2.2.1. 2.2 

InidalizeTmck 

2.4.2.1.1 

InidalizeTruck 

2.5.2.1.1 

Inidalizing  MCC  Software 

2.1.1 

InitIndirectFire 

2.1.2.4.1 

InitOverviewBranch 

2.13.8.13.3 

InitOverviewEvent 

2.13.8.13.2 

InitOverviewFetch 

2.13.8.13.1 

InitPopDenMap 

2.1.2. 2.1 

InitProcessTable 

2.1. 1.4.1 

InitRadios 

2.21.1.23.1 

InitShMem 

2.21.2.12.5 

InitTeamState 

2.16.4  11.1 

• 

InitToolbox 

2.22.1.20.1 

InitTruckState 

2.15.5.7.1 

InitUnit 

2.21.1.19.4 

InitVehicleTables 

2.1. 1.5.2 

init_cache_map 

2.21.7.10.3 

lnit_MCC_Processing 

2.1. 1.2. 8 

init_object_and_texture_names 

2.21.7.15.21 

init_patch_guard.s 

2.21.7.10,4 

init_patch_indices 

2.21.7.10.1 

Init_PDU_  Dispatch 

2.1.1  2.6 

init_rect 

2. 1.8. 1.3 

init_teiTain_cache 

2.21.7.10.2 

inside_poly 

2.19.4.1.3 

install.c 

2.22.1.21 

InstallAmmoEntr) 

2.22.3,5  3 

InstallClock 

2.22.1.6.4 

InstallDrawRoutine 

2. 17.::. 1.1 

InstallFireTargct 

2.17.4.1.10 

InstallFPFTargct 

2.17.4.2.9 

InstalIScrollTableEntr>’ 

2.2^  i,2I  1 

• 
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Interface  between  Admin  Console  and  MCC  Host 

2.15.2 

Interface  between  Maint  Console  and  MCC  Host 

2.16.1 

Internal  Structure 

1.3 

InterpolatePoints 

2.17.3.2.5 

InterpolatePoints 

2.22.1.23.4 

InterProcess  Communication  Status  Command 

2.9.3 

intersect_rect 

2.1.8. 1.2 

Introduction  :  MCC  CSCI  Description 

1 

InvertScroUTableRow 

2.22.1.37.4 

ipc.c 

2.9.3.1 

ipc.h 

2.21.2.1 

ipcerrinit 

2.21.2.13.2 

IPC_errinit 

2.21.2.13.1 

IPC_SystemError 

2.21.2.5.1 

IsCombat  Vehicle 

2. 1.1. 5. 6 

IsGroundVehicle 

2. 1.1. 5. 5 

isLegalGEMSSDensity 

2.19.3.2.1 

isLegalMinefield 

2.19.3.2.2 

IsMortar 

2.6.2. 1.1 

isqrt 

2.22.1.23.1 

keys.h 

2.21.2.2 

KillServiceProcesses 

2.1.5. 1.3 

LabelForceButtons 

2.22.1.16.1 

LastCaution 

2.21.1.4.3 

libassoc 

2.20.1 

libbbd 

2.21.3 

libipc 

2.21.2 

libipcerrs.c 

2.21.2.13 

libipcerrs.err 

2.21.2.14 

libmac 

2.22.1 

libmac.h 

2.22.1.1 

libmatrix 

2.21.4 

libmcc 

2.21.1 

libmove 

2.21.5 

libnet.h 

2.20.2.26 

libnetif 

2.20.2 

libshm 

2.21.6 

libsim 

2.22.2 

libsim.h 

2.22.2.1 

libsimjnt.h 

2.22.2.2 

libsupply 

2.22.3 

libsupply.h 

2.22.3.1 

libsupplyjnt.h 

2.22.3.6 
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libtdb 

2.21.7 

LimitCheck 

2.22.2.8.1 

limits.c 

2.18.2.3 

line_crosses_rect 

2.1.8.1.1 

Listening  to  the  SIMNET  Local  Area  Network 

2.1.6 

LkUpSocket 

2.21.2.10.10 

load.c 

2.15.1.1 

load.c 

2.17.8.2 

load.c 

2.18.2.4 

load.c 

2.22.2.6 

LoadCannedALOC 

2.13.1.1.1 

LoadCannedCAS 

2.13.4.1.1 

LoadCannedCSS 

2.13.3.1.1 

LoadCannedData 

2.13.8.15.2 

LoadCannedData 

2.15.5.3.1 

LoadCannedData 

2.16.4.4.1 

LoadCannedExercise 

2.13.8.11.1 

LoadCannedFireT  argets 

2.17.8.2.3 

LoadCannedFPFTargets 

2.17.8.2.4 

LoadCannedFSE 

2.13.4.2.1 

LoadCannedLimits 

2.18.2.4.2 

LoadCannedResources 

2.19.3.1.2 

LoadCannedSchedule 

2.18.2.4.3 

LoadCannedSimulators 

2.22.2.6.1 

LoadCannedStatus 

2.17.8.2.2 

LoadCannedTerrainMap 

2.14.2.3.2 

LoadCannedTeirainMap 

2.17.8.2.1 

LoadCannedTerrainMap 

2.18.2.4.1 

LoadCannedTerrainMap 

2.19.3.1.1 

LoadCannedTOC 

2.13.1.2.1 

LoadDefaultCEWParameters 

2.13.4.4.1 

LoadFireBuffers 

2.17.1.2.6 

LoadFPFBuffers 

2.17.1.4.8 

LoadGunneryTargets 

2.13.8.12.1 

LoadOptionsPermitted 

2.13.8.11.7 

LoadPresets 

2.13.8.12.6 

LoadPresets 

2. i 7.8. 1.2 

LocalArriveRequest 

2. 6.2. 1.4 

LocalDispatchRequest 

2.6.2. 1.3 

LocalRectToGlobal 

2.19.3.10,1 

LocalToGMTTime 

2. 9. 2. 1.2 

LocalUniiArrived 

2  17.3.2.2 

Local  UniiDispatched 
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LocationInExeiciseArea 

Lock 

lock.c 

lock.c 

lock.c 

LockDialogEvent 

LogExerciseEnd 

longpt.c 

longpt.h 

lookup.c 

LookupAssetNumber 

LookupCCVNumber 

LookupCCVNumber 

LookupFireTarget 

LookupProcessIdentifier 

LookupProcessNumber 

LookupScrollTableEntry 

LookupTruckNumber 

LookupTruckNumber 

ml.c 

ml.c 

MlDetailEvent 

MlFillDetail 

M 1  LoadSavedData 

MlPlaceEvent 

MlPlaceFetch 

MlSeiDefauUs 

m  1  _encode_failures 

m2.c 

in2.c 

M2DetailEvent 

M2DetailFetch 

M2FillDetail 

M2LoadSavedData 

M2PlaceEvent 

MlPlaceFetch 

MlSetDefiiUlts 

m2_encode_failures 

Macinits 

MacintoshTime 

MacQuit 

main 


2.22.2.9.8 

2.21.2.6.3 
2.13.8.14 
2.21.2.6 

2.21.7.23 

2.13.8.14.2 

2.1.5.1.4 

2.22.1.23 
2.22.1.22 

2.22.1.24 
2.8.2.2.1 

2.4.1. 1.9 

2.5.1. 1.9 

2.17.4.1.3 

2.21.1.26.2 

2.21.1.26.3 

2.22.1.24.1 

2.4.1. 1.8 

2.5. 1.1. 8 
2.21.1.20 

2.22.2.7 

2.22.2.7.6 

2.22.2.7.3 

2.22.2.7.2 

2.22.2.7.5 

2.22.2.7.4 

2.22.2.7.1 

2.21.1.20.4 
2.21.1.21 

2.22.2.8 
2.22.2.8.8 

2.22.2.8.7 

2.22.2.8.4 

2.22.2.8.3 

2.22.2.8.6 

2.22.2.8.5 

2.22.2.8.2 

2.21.1.21.4 

2.19.2.1.3 
2.21.1.27.1 

2.19.2.1.4 

2.1. 1.2.9 


main 


2.2. 1.4.1 
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main 

2.3.1. 1.1 

main 

2.4.1. 1.1 

main 

2.5.1. 1.1 

main 

2.6.1. 1.1 

main 

2.7. 1.1.1 

main 

2.8.1. 1.1 

main 

2.9.1. 1.3 

main 

2.10.1.1.1 

main 

2.10.1.2.1 

main 

2.13.8.15.1 

main 

2.14.2.3.1 

main 

2.15.5.1.1 

main 

2.16.4.1.1 

main 

2.17.8.3.1 

main 

2.18.2.5.1 

main 

2.19.2.1.1 

main.c 

2.2. 1.4 

main.c 

2.3.1. 1 

main.c 

2.4.1. 1 

main.c 

2.5. 1.1 

main.c 

2.6.1. 1 

main.c 

2.8.1. 1 

main.c 

2.9.1. 1 

main.c 

2.13.8.15 

main.c 

2.14.2.3 

main.c 

2.15.5.1 

main.c 

2.16.4.1 

main.c 

2.17.8.3 

main.c 

2.18.2.5 

main.c 

2.19.2.1 

MainEventLxx3p 

2.13.8.15.3 

MainEventLoop 

2.14.2  3.3 

MainEventLoop 

2.15.5.1.3 

MainEventLoop 

2.16.4.1.3 

MainEventLoop 

2.17.8.3.3 

MainEventLoop 

2.18.2.5.2 

MainEventLoop 

2.19.2.1.2 

MainHelpButton 

2.19.3  5.5 

Maint  Console  Definitions 

2.16.3 

Maint  Console  Software 

2.16.4 

.Maint  Pictures 

2.16.5.1 

maint, c 

2. 1.6.1 

Main:  li 
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MaintMac.h 

2.16.3.2 

• 

MaintTruckTableFetch 

2.13.3.4.8 

Make_Breach_Status 

2.1.8.3.16 

Make_Minefield_Status 

2.1.8.3.17 

make_polygon 

2.1.8.1.5 

manifest.h 

2.22.5.6 

map.c 

2.21.7.24 

map.c 

2.22.1.26 

map.h 

2.21.7.2 

map.h 

2.22.1.25 

MapAmmoCode 

2.6.3.1.5 

MapScrollTableSelected 

2.22.1.33.1 

map_buffers 

2.20.2.21.2 

map_enp 

2.20.2.21.3 

marker.c 

2.1.8.2 

Markerlnterval 

2.1.1.3.18 

MarkerSpacing 

2.1.1.3.17 

Marker_Add_Line 

2.1.8.2.2 

Marker_Broadcast_Markers 

2.1. 8.2.3 

Marker_Emplace_Minefield 

2.1.8.2.1 

Marker_Get_Next_Marker 

2.1.8.2.4 

Marker_Point_In_Terrain 

2.1.8.2.5 

• 

MarkField 

2.19.3.9.4 

mask.c 

2.20.1.13 

Masscomp  Communication  Software 

2.1 

master.c 

2.13.8.16 

MCC  Includes 

2.22.5 

mccerrinit_ 

2.21.1.33.2 

MCCRoleEvent 

2.13.8.11.3 

MCCRoleFetch 

2.13.8.11.2 

MCC_errinit 

2.21.1.33.1 

MCC_errs.c 

2.21.1.33 

MCC_errs.err 

2.21.1.32 

MCC_limits.h 

2.22.5.4 

MCC_SystemError 

2.21.1.11.3 

memory.c 

2.21.2.7 

memory  .c 

2.21.7.25 

memory_init 

2.21.7.25.2 

memory_terminate 

2.21.7.25.3 

menu.c 

2.17.8.4 

MenuBarTitle 

2.22.1.43.1 

MenuCommand 

2.17.8.4.5 

• 

menus.c 

2.19.2.2 
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niil_to_fixedpt 

Minefield  Geometry 

Minefield  Simulation 

minefield.c 

MineScanlnterval 

Mines_Breach_Lane 

Mines_Check_Minefields 

Mines_Emplace_Breach 

Mines_En:^)lace_Minefield 

Mines_Get_Info 
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